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内 容 简 介 


本 书 详细 阐述 了 与 Kotlin 开发 相关 的 基本 解决 方案 , 主要 包括 俄罗斯 方块 游戏 .设计 并 实现 Messenger 
后 端 应 用 程序 、 在 数据 库 中 存储 信息 、Android App 的 安全 和 部 署 、Place Reviewer 后 台 应 用 程序 、Place 
Reviewer 前 端 设 计 等 内 容 。 此 外 ， 本 书 还 提供 了 相应 的 示例 、 代 码 ， 以 帮助 读者 进一步 理解 相关 方案 的 实 
本 书 适合 作为 高 等 院 校 计 算 机 及 相关 专业 的 教材 和 教学 参考 书 , 也 可 作为 相关 开发 人 员 的 自学 教材 和 
参考 手册 。 
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译 者 F 


Kotlin 是 一 种 新 型 语言 且 具 有 较 好 的 稳定 性 ， 并 可 在 所 有 Android 设备 上 运行 ， 同 时 
还 解决 了 Java 无 法 处 理 的 许多 问题 。Kotlin 为 Android 开发 平台 引入 了 许多 已 被 证 实 的 编 
程 概念 ， 使 得 开发 过 程 变 得 更 加 轻松 ， 并 可 生成 更 具 安全 性 、 表 现 力 和 简洁 的 代码 。 

同时 ， 也 希望 读者 具备 开阔 的 头脑 ， 以 及 对 新 技术 的 渴望 之 心 ， 这 对 于 程序 设计 学 习 
来 说 十 分 有 益 。 针 对 于 此 ， 本 书 精心 挑选 了 与 Kotlin 语言 相关 的 开发 实例 ， 涉 及 俄罗斯 方 
块 游戏 、 设 计 并 实现 Messenger 后 端 应 用 程序 、 数 据 库 中 的 信息 存储 、Android App 的 安全 
和 部 署 、Place Reviewer 后 台 应 用 程序 、Place Reviewer 前 端 设 计 等 内 容 。 这 里 ， 我 们 也 建 
议 读者 重点 考查 相关 代码 ， 并 理解 其 所 执行 的 任务 。 除 此 之 外 ， 还 需要 亲自 实现 、 运 行书 
中 的 每 一 个 程序 。 
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mie. SRA, Teu. TR. TREK. XUDH. EGR, ZEA. TRUM. vex. YESEDE. XI, E 
WE. sep. BRIR, UFR. XUN. KER UAL. SEE BS TABLE, 
在 此 一 并 表示 感谢 。 
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自 Google 宣布 Kotlin 为 官方 支持 的 Android 语言 以 来 , 该 语言 的 受 欢 迎 程度 大 幅 上 升 ， 
这 也 反映 了 Kotlin 是 一 种 设计 良好 的 现代 编程 语言 ， 并 适用 于 多 个 开发 领域 ， 包 括 Web、 
移动 开发 以 及 原生 开发 。 由 于 受 欢迎 程度 的 不 断 提 高 ， 多 年 以 来 ，Kotlin 用 户 一 直 保持 着 
稳定 的 增长 。 


适用 读者 


本 书 适 用 于 各 种 年 龄 层 以 及 不 同 水 平 的 读者 。 也 就 是 说 ， 本 书面 向 初学 者 以 及 具有 一 
定 开 发 经 验 的 程序 员 ， 他 们 想 要 学 习 Kotlin 语言 方面 的 知识 。 

在 本 书 的 编写 过 程 中 ， 我 特别 注意 到 了 以 下 一 个 事实 : 初学 者 需要 轻松 地 理解 相关 主 
题 和 概念 。 为 此 ， 本 书 各 章 是 按照 难度 递增 的 书 顺序 编写 的 。 如 果 读 者 恰好 是 一 名 初学 者 ， 
本 书 可 使 您 快速 融入 学 习 过 程 中 ， 同 时 保持 学 习 的 连贯 性 。 

相 比较 而 言 ， 具 有 一 定 开 发 经 验 的 读者 则 会 更 加 流畅 地 阅读 本 书 一 一 一 切 都 是 平等 
的 。 如 果 读 者 具有 应 用 程序 开发 的 相关 经 验 ， 那 么 ， 可 以 选择 先 浏览 本 书 的 示例 代码 ， 以 
了 解 所 涵盖 的 主题 和 所 期 望 的 内 容 。 特 别 是 Java 开发 人 员 ， 他 们 可 以 直接 阅读 书 中 更 高 级 
的 内 容 。 

无 论 属于 哪 种 类 型 的 读者 ， 请 放心 ， 我 们 依然 为 您 撰写 了 相关 的 主题 。 


ABA 


第 1 章 讨 论 了 如 何 利 用 Kotlin 语言 编写 简单 的 应 用 程序 ， 包 括 构建 Android 项 目 、 学 
JFR Android 应 用 程序 所 需 的 基础 知识 ， 并 以 此 与 Web 服务 器 进行 通信 。 

第 2 章 介 绍 一 款 相对 简单 的 游戏 作品 , 即 俄罗斯 方块 , 以 使 读者 能 够 快速 进行 Android 
项 目 开 发 。 

第 3 章 介绍 了 如 何 生成 视图 、 利 用 模型 实现 应 用 程序 逻辑 , 并 实现 数据 的 视图 化 操作 。 
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除 此 之 外 ， 本 章 还 将 学 习 UI 事件 处 理 方面 的 内 容 。 

第 4 章 将 探讨 如 何 设计 和 实现 后 台 程序 ， 进 而 向 客户 端 应 用 程序 提供 Web 资源 。 

第 5 章 涉及 模型 -视图 -表示 模式 的 应 用 , 从 而 编写 一 个 可 与 Messenger 后 端 程序 通信 的 
Messenger 应 用 程序 。 

第 6 章 则 在 第 S 章 的 基础 上 ， 进 一 步 完 善 Messenger 应 用 程序 的 开发 。 

第 7 章 解释 了 Android 框架 所 支持 的 各 种 数据 存储 方法 。 除 此 之 外 ， 本 章 还 将 学 习 如 
何 使 用 这 些 方法 存储 /获取 有 效 的 应 用 程序 信息 。 

第 8 章 逐 步 分 析 了 Android 应 用 程序 的 部 署 问题 ， 此外， 本 章 还 涵盖 了 较为 重要 的 
Android 应 用 程序 安全 方面 的 问题 。 

第 9 章 利用 Spring MVC 详细 讨论 了 后 台 程 序 的 设计 和 实现 过 程 ， 即 Place Reviewer 
Web 应 用 程序 。 

第 10 章 分 析 了 如 何 创建 一 个 Web 定位 程序 ， 并 学 习 使 用 强大 的 Google Places API。 
另外 ， 本 章 还 将 学 习 如 何 针对 Web 应 用 程序 编写 测试 程序 。 

对 于 初学 者 来 说 ， 和 希望 读者 秉承 一 种 开放 、 主 动 的 学 习 态度 。 在 学 习 一 门 新 语言 时 ， 
开始 阶段 可 能 会 遇 到 种 种 问题 ， 但 只 要 坚持 不 懈 ， 终 将 会 获得 成 功 。 这 里 也 建议 读者 逐 章 
阅读 本 书 ， 确 保 掌 握 书 中 的 全 部 内 容 。 特 别 需要 指出 的 是 ， 应 重点 考查 相关 代码 ， 并 理解 
其 所 执行 的 任务 。 同 时 ， 还 需要 亲自 实现 、 运 行书 中 的 每 一 个 程序 。 


资源 下 载 


读者 可 访问 http://www.packtpub.com 并 通过 个 人 账户 下 载 示例 代码 文件 。 另 外 ， 读 者 
在 购买 本 书后 ， 可 访问 http:/www.packtpub.com/support， 注 册 成 功 后 ， 我 们 将 以 电子 邮件 
的 方式 将 相关 文件 发 与 读者 。 

读者 可 根据 下 列 步骤 下 载 代码 文件 : 

Q 访问 并 注册 我 们 的 网 站 对 应 网 址 为 http:/www.packtpub.com) 。 

Q 选择 SUPPORT 选项 卡 。 

口 单 击 Code Downloads & Errata。 

口 在 Search 文 本 框 中 输入 书 名 。 

当 文件 下 载 完 毕 后 ， 确 保 使 用 下 列 最 新 版 本 软件 解压 文件 夹 : 

Q Windows 系统 下 的 WinRAR/7-Zip。 
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O Mac 系统 下 的 Zipeg/iZip/UnRarX. 
Q Linux 系统 下 的 7-Zip/PeaZip. 

同时 ， 读 者 还 可 访问 GitHub 获取 本 书 的 代码 包 ， 对 应 网 址 为 https:/github.com/ 
PacktPublishing/Kotlin-Programming-By-Example. 

此 外 ， 读 者 还 可 访问 https://github.com/PacktPublishing/ 以 了 解 丰 富 的 代码 和 视频 资源 。 


下 载 书 中 的 彩色 图 像 


我 们 还 提供 了 相关 PDF 文件 ， 其 中 包含 了 本 书 中 与 屏幕 截图 、 示 意图 相关 的 彩色 图 像 ， 读 
者 可 访问 https://www.packtpub.com/sites/default/files/downloads/KotlinProgrammingByExample_ 
ColorImages. pdf 下 载 。 


本 书 约定 


代码 块 则 通过 下 列 方式 设置 : 
release { 
storeFile file("../my-release-key.jks") 
storePassword "password" 
keyAlias "my-alias" 
keyPassword "password" 
} 
代码 中 的 重点 内 容 则 采用 黑体 表示 : 
release { 
storeFile file("../my-release-key.jks") 
storePassword "password" 
keyAlias "my-alias" 


keyPassword "password" 


} 
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命令 行 输 入 或 输出 如 下 所 示 : 
./gradlew assembleRelease 


图 标 表 示 较为 重要 的 说 明 事 项 . 
使 图 标 则 表示 提示 信息 和 操作 技巧 。 


读者 反馈 和 客户 支持 


欢迎 读者 对 本 书 的 建议 或 意见 予以 反馈 ， 以 使 我 们 进一步 了 解读 者 的 阅读 喜好 。 

反馈 意见 对 于 我 们 来 说 十 分 重要 ， 以 便 改 进 我 们 日 后 的 工作 。 对 此 ， 读 者 可 向 
feedback@packtpub.com 发 送 邮件 ， 并 以 书 名 作为 邮件 标题 。 

尽管 我 们 在 最 大 程度 上 做 到 尽善尽美 , 但 错误 依然 在 所 难免 。 如 果 读 者 发 现 谬误 之 处 ， 
无 论 是 文字 错误 抑或 是 代码 错误 ， 还 望 不 将 赐教 。 对 于 其 他 读者 以 及 本 书 的 再 版 工作 ， 这 
将 具有 十 分 重要 的 意义 。 对 此 ， 读 者 可 访问 http://www.packtpub.com/submit-errata， 选 取 对 
应 书籍 ， 单 击 ErrataSubmissionForm 超 链接 ， 并 输入 相关 问题 的 详细 内 容 。 

若 读者 在 互联 网 上 发 现 本 书 任意 形式 的 副本 ， 请 告知 网 络 地 址 或 网 站 名 称 ， 我 们 将 对 
此 予以 处 理 。 关 于 盗版 问题 ， 读 者 可 发 送 邮件 至 copyright@packtpub.com. 

若 读者 针对 某 项 技术 具有 专家 级 的 见解 ， 抑 或 计划 撰写 书籍 或 完善 某 部 著作 的 出 版 工 
作 ， 则 可 访问 authors.packtpub.com. 


评论 本 书 


欢迎 读者 对 本 书 的 建议 或 意见 予以 反馈 ， 以 进一步 了 解读 者 的 阅读 喜好 。 
读者 可 访问 packtpub.com 并 获取 与 Packt 相关 的 更 多 信息 。 
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对 于 大 多 数 人 来 讲 ， 学 习 一 门 编程 语言 常会 经 历 某 种 “痛苦 ”的 过 程 ， 人 们 往往 对 
此 望而却步 。 既 然 读 者 选择 阅读 本 书 ， 那 么 ， 我 坚信 读者 对 Kotlin 程序 设计 抱 有 浓厚 的 
兴趣 ， 并 立志 于 成 为 这 一 方面 的 专家 。 在 此 ， 我 也 祝贺 读者 在 学 习 Kotlin 语言 这 一 方面 
迈 出 了 勇敢 的 一 步 。 

对 于 解决 方案 的 问题 领域 ， 无 论 是 应 用 程序 开发 、 网 络 开发 或 者 是 分 布 式 系 统 ， 
Kotlin 语言 均 可 视 作 一 种 较 好 的 选择 ， 并 可 提供 所 需 的 解决 方案 。 也 就 是 说 ， 学 习 Kotlin 
是 一 种 正确 的 方向 ， 下 面 将 对 这 门 语言 中 的 基础 知识 加 以 介绍 。 

Kotlin 是 一 门 强 类 型 、 面 向 对 象 语言 ， 可 运行 于 Java 虚拟 机 (JVM) 上 ， 并 可 用 于 
开发 各 种 问题 领域 中 的 应 用 程序 。 除了 能 够 在 虚拟 机 上 运行 之 外 , Kotlin 语言 还 可 编译 为 
JavaScript， 因 而 可 用 于 开发 客户 端 Web 应 用 程序 。 另 外 ，Kotlin 还 可 以 直接 编译 成 本 地 
二 进 制 文件 ， 这 些 二 进 制 文件 在 缺少 虚拟 机 的 情况 下 可 通过 Kotlin/Native 运行 于 系统 上 。 
JetBrains 发 布 了 Kotlin 程序 设计 语言 ， 这 是 一 家 位 于 俄罗斯 圣彼得堡 的 软件 公司 ， 并 负 
责 对 该 语言 加 以 维护 。 另 外 ，Kotlin 这 一 名 称 取 自 于 圣彼得堡 附近 的 Kotlin 岛 。 

Kotlin 语言 则 在 多 个 领域 内 提供 工业 强度 级 别 的 软件 开发 方案 , 但 就 目前 来 看 , 其 主 
要 应 用 体现 在 Android 生态 圈 。 在 本 书 编写 时 ，Kotlin 是 谷歌 作为 Android 官方 语言 所 宣 
布 的 3 种 语言 之 一 。Kotlin 与 Java 在 语法 上 具有 相似 之 处 。 事 实 上 ， 其 设计 初衷 是 为 了 
更 好 地 替代 Java。 因 此 ， 在 软件 开发 中 使 用 Kotlin 〈 而 不 是 Java) 将 会 体现 诸多 优势 。 

本 章 主要 涉及 以 下 内 容 : 

Kotlin 的 安装 过 程 。 

Kotlin 程序 设计 语言 的 基础 知识 。 
Android Studio 的 安装 和 设置 。 
Gradle. 

Web 基础 知识 。 


DOOCUOLUO 


1.1 开始 Kotlin 之 旅 


HFR Kotlin 应 用 程序 时 ， 首 先 需要 在 计算 机 上 安装 Java 运行 环境 GRE) 。 其 中 ， 
JRE 可 连同 Java 开发 工具 包 IDK) 一 起 下 载 。 当 安装 Kotlin 时 ， 需 要 使 用 到 IDK. 


。2。 Kotlin 语言 实例 精 解 


相应 地 ， 最 为 简单 的 IDK 安装 方式 是 使 用 Oracle (Java 的 拥有 者 ) 提供 的 某 种 IDK 
安装 程序 。 对 于 所 有 的 主流 操作 系统 ，Oracle 提供 了 不 同 的 安装 程序 ， 读 者 可 访问 
http://www.oracle.com/technetwork/java/javase/downloads/index.html 下 载 相关 的 JDK 版 本 ， 
如 图 1.1 所 示 。 


图 1.1 JavaSE Web 页 面 


单 击 JDK 下 载 按钮 即 可 前 往 下 载 页 面 ， 如 图 1.2 所 示 。 其 中 ， 读 者 可 针对 相应 的 操 
作 系 统 以 及 CPU 架构 选取 相应 的 JDK。 此 时 ， 读 者 可 选择 合适 的 IDK 并 执行 后 续 操 作 。 


12 JDK FHM 
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1.1.4. 安装 JDK 


当 在 计算 机 设备 上 安装 IDK 时 , 根据 当前 操作 系统 , 读者 可 检测 一 些 必要 的 安装 信息 。 
1. 在 Windows 设备 上 安装 
通过 下 列 4 个 步骤 ， 可 将 JDK 安装 于 Windows 环境 中 。 
(1) 双击 可 下 载 的 安装 文件 ， 并 运行 IDK 安装 程序 。 
(2) 单 击 欢迎 画面 中 的 Next 按钮 ， 并 选择 需要 安装 的 组 件 。 其 他 内 容 可 保持 默认 
选项 ， 随 后 单 击 Next 按钮 。 
G) 接 下 来 的 窗口 将 提示 用 户 选 择 安装 的 目标 文件 夹 。 当 前 ， 读 者 可 选择 默认 文件 
夹 (但 需要 留意 该 文件 夹 的 位 置 ， 后 续 操作 将 会 使 用 到 该 文件 夹 ) ， 随 后 单 击 Next 按钮 。 
(4) 遵循 后 续 窗 口中 的 各 项 说 明 ， 并 单 击 Next 按钮 。 其 间 ， 读 者 将 被 询问 输入 管 
理 员 密 码 。 随 后 ，Java 将 被 安装 至 用 户 的 计算 机 中 。 
JDK 安装 完毕 后 ， 还 需要 设置 JAVA_HOME 环境 变量 。 对 此 ， 可 执行 下 列 步 又 : 
(1) 打开 Control Panel。 
(2) 选择 Edit environment variable。 
(3) 在 开启 的 窗口 中 ， 单 击 New 按钮 ， 此 时 将 被 提示 添加 新 的 环境 变量 。 
(4) 作为 变量 名 输入 JAVA_HOME， 并 作为 变量 值 输入 JDK 的 安装 路 径 。 
(5) 单 击 OK 按钮 以 添加 环境 变量 。 
2. 在 macOS 设备 上 安装 
当 在 macOS 上 安装 IDK 时 ， 需 要 执行 下 列 步 又 : 
(1) 下 载 所 需 的 JDK .dmg 文件 。 
(2) 找到 下 载 后 的 .dmg 文件 并 双击 该 文件 。 
(3) 包含 JDK 数据 包 图 标的 查找 窗口 将 被 打开 。 双 击 该 图 标 并 启动 安装 程序 。 
(4) 单 击 简介 窗口 的 Continue 按钮 。 
(5) 单 击 安装 窗口 的 Install 按钮 。 
(6) 输入 管理 员 账 户 和 密码 ， 并 单 击 Install Software 按钮 。 
至 此 ，JDK 安装 完毕 ， 随 后 将 显示 配置 窗口 。 


3. 在 Linux 上 安装 


通过 apt-get 命令 ， 在 Linux 上 安装 IDK 则 较为 简单 和 直观 ， 对 应 步骤 如 下 : 
(1) 更 新 计算 机 上 的 数据 包 索 引 ， 并 在 终端 上 运行 下 列 命令 : 


sudo apt-get update 
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(2) 运行 下 列 命令 并 检测 是 否 已 经 安装 了 Java: 


java -version 


G) 如 果 输 出 了 Java 系统 安装 的 版 本 信息 ， 则 说 明 Java 已 被 安装 完毕 。 如 果 未 安 
装 任何 版 本 ， 则 运行 下 列 命令 : 


sudo apt-get install default-jdk 


至 此 ，JDK 已 被 安装 在 计算 机 上 。 
1.1.2. 编译 Kotlin 程序 


在 安装 了 IDK 后 ， 还 需要 一 种 方式 可 编译 和 运行 Kotlin 程序 。 

Kotlin 程序 可 直接 利用 Kotlin 命令 行 编译 器 进行 编译 ; 或 者 通过 集成 开发 环境 ODE) 
构建 和 运行 。 

1. 与 命令 行 编译 器 协同 工作 

命令 行 编译 器 可 通过 Homebrew、SDKMAN! 和 MacPorts 进行 安装 。 另 一 种 设置 命令 
行 编译 器 的 方法 是 通过 手动 安装 。 

2. 在 macOS 上 安装 命令 行 编译 器 

Kotlin 命令 行 编译 器 可 通过 多 种 方式 在 macos 上 安装 。 对 此 ， 较 为 常见 的 两 种 方式 
是 Homebrew 和 MacPorts. 

(1) Homebrew 

Homebrew 是 一 个 macOS 系统 的 数据 包 管理 器 ， 广 泛 地 用 于 安装 软件 项 目 时 数据 包 
的 安装 。 当 安装 Homebrew 时 ， 可 查找 macOS 终端 并 运行 下 列 命令 : 

/usr/bin/ruby -e "$(curl -fsSL 

https://raw.githubusercontent.com/Homebrew/install/master/install)" 

此 时 ， 用 户 需 要 等 待 数秒 ， 以 下 载 和 安装 Homebrew。 安 装 完毕 后 ， 可 在 终端 上 运行 
下 列 命令 ， 以 查看 Homebrew 是 否 可 正常 工作 。 


brew -v 

如 果 系 统 终端 上 输出 了 Homebrew 的 当前 版 本 ， 则 表明 Homebrew 已 经 成 功 地 安装 
在 计算 机 上 。 

当 安 装 了 Homebrew 后 ， 可 查找 终端 并 执行 下 列 命令 : 


brew install kotlin 
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稍 作 等 待 后 即 可 完成 安装 过 程 。 随 后 即 可 利用 命令 行 编译 器 编译 Kotlin 程序 。 

(2) MacPorts 

类 似 于 Homebrew, MacPorts 也 是 一 个 针对 macOS 的 数据 包 管 理 器 ， 并 可 通过 下 列 
步 又 安装 在 系统 上 : 

CD 安装 Xcode fil Xcode 命令 行 工 具 。 

© 接受 Xcode 许可 ， 即 在 终端 上 运行 xcodebuild -license 命令 。 

© 安装 所 需 的 MacPorts 版 本 。 

读者 可 访问 https://www.macports.org/install.php 下 载 MacPort。 待 下 载 完 毕 后 ， 可 查 
找 终 端 并 以 超级 用 户 身份 运行 port install kotlin 命令 ， 如 下 所 示 : 

sudo port install kotlin 

3. fr Linux 上 安装 命令 行 编译 器 

利用 SDKMAN!，Linux 用 户 可 方便 地 安装 命令 行 编译 器 。 

SDKMANI! 可 用 于 在 基于 UNIX 的 系统 上 安装 数据 包 ， 例 如 Linux 及 其 各 种 版 本 
(Fedora fil Solaris 版 本 ) 。SDKMANI! 的 安装 过 程 包含 以 下 3 个 步骤 : 

CD 利用 curl 命令 将 软件 下 载 至 系统 上 。 定 位 系统 并 运行 下 列 命令 : 

curl -s "https://get.sdkman.io" | bash 

(2) 随后 将 在 终端 中 显示 一 系列 的 指令 ， 用 户 可 遵循 这 些 指令 并 完成 安装 过 程 。 安 
装 完毕 后 ， 可 运行 下 列 命令 : 

source "$HOME/.sdkman/bin/sdkman-init.sh" 

(3) 运行 下 列 命令 : 

sdk version 

如 果 SDKMANI! 的 版 本 号 显示 于 终端 窗口 中 ， 则 说 明 安 装 成 功 。 

在 SDKMAN! 于 系统 中 安装 完毕 后 ， 可 通过 下 列 命令 安装 命令 行 编译 器 : 

sdk install kotlin 


4. 在 Windows 上 安装 命令 行 编译 器 
当 在 Windows 环境 下 使 用 Kotlin 命令 行 编译 器 时 ， 需 要 执行 以 下 步骤 : 
(1) 访 问 https://github.com/JetBrains/kotlin/releases/tag/v1.2.30, 并 下 载 软件 的 GitHub 
版 本 。 
(2) 定位 并 解压 下 载 后 的 文件 。 
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(3) 打开 解压 后 的 kotline\bin 文件 夹 。 
(4) 执行 包含 文件 夹 路 径 的 命令 提示 符 。 
至 此 ， 读 者 可 通过 命令 行使 用 Kotlin 编译 器 。 


1.1.3 ”运行 第 一 个 Kotlin 程序 


前 述 内 容 讨 论 了 命令 行 编译 器 的 设置 过 程 ， 下 面 尝试 运行 一 个 简单 的 Kotlin 程序 。 
对 此 ,可 访问 主 目录 并 创建 一 个 名 为 Hello.kt 的 新 文件 。 注意， 所 有 的 Kotlin 文件 均 包含 
了 .kt 后 级 扩展 名 。 

在 文本 编辑 器 中 打开 刚刚 生成 的 文件 ， 并 输入 下 列 内 容 : 

// The following program prints Hello world to the standard system output. 

fun main (args: Array<String>) { 

println("Hello world!") 

) 


保存 文件 ， 打 开 终 端 窗口 并 输入 下 列 命令 。 


kotlinc hello.kt -include-runtime -d hello.jar 


上 述 命 令 将 程序 编译 为 hello.jar 可 执行 文件 。 3€ 8, -include-runtime 标记 用 于 指定 需 
要 编译 为 JAR。 在 向 命令 中 添加 了 该 标记 后 ，Kotlin 运行 库 将 纳入 JAR 中 。 另 外 。-d 标 
记 表 明 ， 需 要 调用 编译 器 的 输出 结果 。 

在 第 一 个 Kotlin 程序 被 编译 后 ， 下 面 将 运行 该 程序 。 打 开 终 端 窗口 (如 果 尚 未 开启 ， 
可 访问 保存 JAR 文件 的 所 在 目录 ) ， 运 行 编译 后 的 JAR 文件 ， 并 执行 下 列 命令 : 


java -jar hello.jar 


在 运行 了 上 述 命令 后 ，“Hello world!” 将 被 输出 至 显示 窗口 中 。 恭 喜 ! 读者 已 经 成 
功 地 运行 了 第 一 个 Kotlin 程序 。 

1. 利用 Kotlin 编写 脚本 

如 前 所 述 ，Kotlin 还 可 用 于 编写 脚本 。 对 于 某 些 共 同 目标 〈 自 动 执 行 任务 ) ， 脚 本 是 
为 特定 的 运行 环境 编写 的 程序 。 在 Kotlin 中 ， 脚 本 文件 包含 了 .kts BAP A. 

Kotlin 脚本 的 编写 方式 与 Kotlin 程序 类 似 。 实际 上 , 采用 Kotlin 编写 的 脚本 与 Kotlin 
常规 程序 十 分 相似 ， 二 者 间 唯 一 的 差别 在 于 主 函数 。 

在 所 选 文 件 夹 中 生成 一 个 文件 , 并 将 其 命名 为 NumberSum kts。 打开 该 文件 并 输入 下 
列 程序 : 


val x: Int = 1 

val y: Int = 2 
val zs Int = x * y 
println(z) 


相信 读者 已 经 猜 到 ， 上 述 脚本 将 输出 两 个 数字 (1 和 2) 之 和 。 保 存 该 文件 ， 并 运行 
当前 脚本 ， 如 下 所 示 : 


kotlinc -script NumberSum.kts 


O xs. 

Kotlin 脚本 无 须 进 行 编译 

2. 使 用 REPL 

REPL 表示 Read-Eval-Print Loop 的 首 字母 缩写 ，REPL 是 一 个 交互 式 的 shell 环境 ， 
在 该 环境 中 , 程序 可 以 在 给 定 的 即时 结果 下 执行 。 通 过 运行 kotlinc 命令 (无 须 任何 参数 )， 
可 调用 交互 式 shell 环境 。 
O xz. 

当 在 终端 上 运行 kotlinc 时 ， 即 可 启动 Kotlin REPL 

如 果 成 功 地 启动 了 REPL， 终 端 窗口 中 间 显 示 一 条 欢迎 消息 ， 下 一 行 中 的 “>>>” 则 
提示 用 户 ，REPL 正在 等 待 输入 内 容 。 一 如 文本 编辑 器 中 所 做 的 那样 ， 可 向 终端 窗口 中 输 
入 代码 ， 并 从 REPL 中 获取 反馈 结果 ， 如 图 1.3 所 示 。 


图 1.3 KotlinREPL 


其 中 , 整数 1 和 2 分 别 被 赋予 x 和 y Pox Aly 的 求 和 结果 存储 于 新 变量 z 中 。 随后 ， 


z 值 通过 print0 函 数 输出 至 显示 窗口 中 。 
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1.1.4 在 IDE 中 工作 


利用 命令 行 编写 程序 确实 可 行 ， 但 大 多 数 场合 下 ， 最 好 使 用 专门 为 开发 人 员 编 写 
序 而 构建 的 软件 ， 尤 其 是 开发 大 型 项 目 时 。 
IDE 是 一 种 计算 机 应 用 程序 ， 对 于 软件 开发 来 讲 ， lenge 员 内 置 了 相关 的 工 


具 集 。 相 应 地 ， 存 在 多 种 IDE 可 用 于 Kotlin JF. IntelliJ IDEA 中 包含 了 较为 全 面 的 特 
性 Me, 并 可 用 于 开发 Kotlin 应 用 程序 。 由 于 IntelliJ IDEA 由 Kotlin 者 们 一 手打 造 ， 


与 其 他 IDE 相 比 ， 其 优势 更 加 明显 ， 例 如 更 好 的 工具 集 以 及 实时 更 新 功能 (包括 Kotlin 
编程 语言 的 最 新 特性 ) 。 


1. 安装 IntelliJ IDEA 


读者 可 访问 JetBrains 网 站 , 并 针对 Windows, macOS 和 Linux 环境 下 载 IntelliJ IDEA, 
对 应 网 址 为 https:/www.jetbrains.comyidea/download。 在 下 载 页 面 中 ， 提 供 了 两 个 下 载 版 
Æ: 付费 Ultimate 版 本 和 免费 的 Community 版 本 ， 如 图 1.4 所 示 。 其 中 ，Community 版 
本 即 可 满足 本 章程 序 的 需要 。 当 然 ， 读 者 可 根据 个 人 喜好 下 载 相关 版 本 。 


IntelliJ IDEA Whats New Features Learn Buy Download 


Download IntelliJ IDEA 


Windows macos Linux 
Ultimate Community 
For web and enterprise For JVM and Android 
development development 


Version: 20723 
Build: 172.396816 


Released: August 29, 2017 
DOWNLOAD 
stem r nts 
Insti ions 


Free trial 
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图 1.4 IntelliJ IDEA 下 载 页 面 
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2. 利用 IntelliJ 设置 Kotlin 项 目 


利用 IntelliJ 设置 Kotlin 项 目 主要 包括 以 下 几 个 步骤 : 

(1) JAB) IntelliJ IDE 应 用 程序 。 

(2) 单 击 Create New Project 按钮 。 

(3) 在 左 侧 打开 窗口 中 从 现 有 项 目 选项 中 选择 Java。 

(4) 作为 附加 库 向 当前 项 目 中 添加 Kotlin/J/VM 

(5) 从 窗口 下 拉 菜 单 中 选取 SDK 项 目 。 

(6) 单 击 Next 按钮 。 

(7) 选取 模板 〈 如 有 必要 ) ， 并 执行 后 续 操作 。 

(8) 在 输入 文本 框 中 提供 项 目 名 称 。 当 前 项 目 命名 为 HelloWorld。 
C9) 在 输入 文本 框 中 设置 项 目 位 置 。 
(10) 单 击 Finish 按钮 。 

至 此 ， 项 目 创建 完毕 ， 并 显示 于 IDE 窗口 中 ， 如 图 1.5 所 示 。 


— 


= 


ler 


图 1.5 包含 当前 项 目的 IDE 窗口 


其 中 ， 窗 口 左 侧 显示 了 项 目 视图 ， 包 括 项 目 文件 的 逻辑 结构 。 
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比 外 ， 还 包含 了 以 下 两 个 文件 夹 。 

QO idea 文件 夹 : 包含 了 IntelliJ 项 目 设置 文件 。 

O sre 文件 夹 : 即 项 目的 源 文件 夹 ， 可 于 其 中 放置 程序 文件 。 
在 项 目 构建 完毕 后 ， 即 可 着 手 编写 简单 的 程序 。 这 里 ， 可 向 源 文件 夹 中 添加 名 为 

hello.kt 的 文件 (在 src 文件 夹 上 单 击 鼠 标 右键 ， 在 弹出 的 快捷 菜单 中 选择 New | Kotlin 

File/Class 命令 ， 并 将 对 应 文件 命名 为 hello) 。 随 后 ， 可 向 文件 中 复制 、 粘 贴 下列 代 码 ; 
fun main(args: Array<String>) { 


println("Hello world!") 
) 


当 运 行程 序 时 ， 可 单 击 主 函数 一 侧 的 Kotlin 图 标 ， 并 选择 Run HelloKt， 如 图 1.6 所 示 。 


图 1.6 当前 程序 的 运行 结果 
构建 并 运行 当前 项 目 ， 标 准 系 统 输出 窗口 中 即 会 显示 “Hello world!”。 
12 Kotlin 编程 语言 基础 知识 

在 开发 环境 和 IDE 设置 完毕 后 ， 可 对 Kotlin 语言 本 身 稍 作 解 释 。 我 们 将 从 语言 的 基 
本 知识 开始 ， 并 逐步 深入 更 高 级 的 主题 ， 例 如 面向 对 象 程 序 (OOP) 设计 。 
1.2.1 Kotlin 知识 

本 节 将 讨论 Kotlin 语言 的 基础 知识 ， 并 尝试 构建 代码 块 。 下 面 首 先 考 察 变量 。 

hss 

变量 表示 为 加 载 某 个 值 的 、 内 存 位 置 的 标识 符 。 对 此 ， 一 种 简单 的 变量 描述 方式 是 : 
加 载 某 个 数值 的 标识 符 。 考 察 下 列 程序 : 


fun main(args: Array<String>) { 


la 


var xs Ine =L 


} 
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在 上 述 代码 中 ，x 定义 为 一 个 变量 ， 对 应 的 加 载 值 为 1。 特 别 地 ，x 表示 为 一 个 整数 
变量 。 由 于 X 定义 为 包含 Int 数据 类 型 ， 因 而 将 作为 一 个 整数 变量 被 引用 。 更 准确 地 讲 ， 
X 表示 为 nt 类 实例 。 或 许 ， 读 者 会 对 术语 “实例 ”和 “类 ”感到 迷惑 ， 后 续 章节 将 对 此 
加 以 讨论 。 当 前 ， 让 我 们 把 注意 力主 要 集中 于 变量 上 。 

HE Kotlin 中 定义 一 个 变量 时 ， 可 使 用 var 关键 字 ， 进 而 表明 可 对 该 变量 进行 修改 。 
而 所 声明 变量 的 数据 类 型 则 位 于 冒号 之 后 。 需 要 注意 的 是 ， 无 须 显 式 地 定义 变量 的 数据 类 
型 ，Kotlin 支持 类 型 推断 机 制 ， 即 根据 定义 推断 对 象 的 类 型 。 因 此 ， 变 量 x 的 定义 可 记 为 : 


var x = 1 


另外 ， 也 可 以 在 变量 定义 结尾 处 添加 一 个 分 号 。 通 常情 况 下 ， 分 号 无 须 添加 ， 这 一 
点 与 JavaScript 十 分 类 似 ， 如 下 所 示 : 

var x 1 //I am a variable identified by x and I hold a value of 1 

var y 2 //I am a variable identified by y and I hold a value of 2 


var z: Int - x * y //I am a variable identified by z and I hold a value 
//of 3 


相应 地 ， 在 程序 执行 过 程 中 ， 如 果 不 希望 修改 变量 值 ， 可 将 其 设置 为 不 可 变 变量 ， 
并 通过 关键 字 val 定义 ， 如 下 所 示 。 

(1) 变量 的 作用 域 

变量 作用 域 是 指 程序 中 变量 的 作用 区 域 。 也 就 是 说 ， 变 量 的 作用 域 表 示 为 变量 可 用 
的 程序 区 域 。Kotlin 变量 包含 了 块 作用 域 。 因 此 ， 变 量 可 以 在 对 应 块 所 定义 的 所 有 区 域 中 
使 用 ， 如 下 所 示 : 

fun main(args: Array<String>) { 

// block A begins 


vara 10 
1 


var i 


while (i < 10) { 
// block B begins 
valb=a/i 
print (b) 
ict 
} 
print(b) // Error occurs: variable b is out of scope 


j; 


上 述 程序 体现 了 块 作用 域 的 效果 ， 其 中 包含 了 两 个 块 。 此 处 ， 函 数 定义 开启 了 一 个 新 
Be, 在 当前 示例 中 将 其 标记 为 A。 在 A rp, 声明 了 变量 a 和 i。 因 此 , a 和 i 的 作用 域 为 A。 
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A 中 还 创建 了 一 个 while 循环 ， 同 时 开启 了 B 块 。 这 里 ， 循 环 声明 标记 了 新 块 的 开 
始 位 置 。 在 B 中 ， 声 明了 一 个 变量 b。 因 此 , b 值 存在 于 B 作用 域 中 ， 且 无 法 在 其 外 部 加 
以 使 用 。 当 在 B 块 之 外 试图 输出 b 值 时 ， 将 会 产生 错误 。 
需要 注意 的 是 ，a 和 i 变量 仍 可 在 B 块 中 加 以 使 用 一 一 B 处 于 A 的 作用 域 范 围 内 。 
(2) 局 部 变量 
此 类 变量 局 部 于 某 个 作用 域 。 在 上 述 示例 中 ，a、i 和 均 为 局 部 变量 。 
2. 运算 数 和 运算 符 
运算 符 可 视 作 指令 中 的 部 分 内 容 ， 用 于 计算 所 操作 的 数值 。 另 外 ， 运 算 符 对 其 运算 
数 执行 特定 的 运算 ， 运 算 符 示例 包括 +、-、*、/ 和 %。 运 算 符 可 根据 所 执行 的 操作 类 型 ， 
以 及 运算 数 的 数量 进行 分 类 。 
根据 运算 符 所 执行 的 操作 类 型 ， 可 将 运算 符 划分 为 以 下 几 种 类 型 
口 关系 运算 符 。 
Q 赋值 运算 符 。 
口 逻辑 运算 符 。 
口 ”位 运算 符 。 
运算 符 类 型 的 相关 示例 如 表 1.1 所 示 。 


表 1.1 运算 符 类 型 及 其 示例 


运算 符 类 型 zm ø 

关系 运算 符 > <, >=, <=, = 

赋值 运算 符 == Eye 

逻辑 运算 符 &&, | ! 

算术 运算 符 ty s A 

位 运算 符 and(bits), or(bits), xor(bits), inv(). shl(bits), shr(bits), ushr(bits) 
根据 运算 数 的 数量 ，Kotlin 中 包含 了 以 下 两 种 主要 类 型 ; 
口 “ 一 元 运算 符 。 


Q 二 元 运算 符 。 
对 应 示例 如 表 1.2 所 示 。 
表 1.2 一 元 运算 符 和 二 元 运算 符 
运算 符 类 型 jo x m Fil 
一 元 运算 符 仅 包 含 一 个 运算 数 l t — 
二 元 运算 符 包含 两 个 运算 数 | 
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3. 数据 类 型 

变量 类 型 表示 为 变量 可 加 载 的 数值 集合 。 在 大 多 数 场合 下 ， 可 显 式 地 指定 声明 变量 
所 加 载 的 数值 类 型 ， 并 可 通过 具体 的 数据 类 型 予以 实现 。 

Kotlin 中 包含 了 以 下 一 些 较为 重要 的 类 型 : 


Ooooco 


u 


Int. 
Float. 
Double. 
Boolean. 
String. 
Char. 
Array. 


(1) Int 


Int 类 型 表示 为 32 位 有 符号 整数 。 当 采用 该 类 型 声明 一 个 变量 时 ， 变 量 的 数值 范围 


为 整数 集 。 也 就 是 说 ， 这 一 类 变量 仅 可 包含 整数 值 。 具 体 来 说 ，Int 类 型 可 加 载 
-2147483648-2147483647 的 整数 值 。 

(2) Float 

Float 类 型 表示 为 单 精度 32 位 浮 点 数 。 对 于 Float 类 型 变量 , 该 变量 仅 可 加 载 浮 点 值 ， 
对 应 范围 为 +3.40282347E+38F (6~7 有 效 小 数位 ) 。 例 如 : 


var pi: Float = 3.142 


(3) Double 
Double 类 型 表示 为 双 精 度 64 位 浮 点 数 。 类 似 于 Float 2878, Double 类 型 表明 所 声明 
的 变量 加 载 浮 点 值 。Double 和 Float 类 型 间 的 主要 差异 在 于 : Double 类 型 可 定义 较 大 范 


围 的 数字 ， 对 应 范围 约 为 +1.79769313486231570E+308 (15 个 有 效 小 数位 ) 。 例 如 : 


var d: Double = 3.142 
(4) 布尔 类 型 
布尔 (Boolean) 类 型 包含 了 true 或 false 逻辑 真 值 ， 如 下 所 示 : 


var t: Boolean = true 


var f: Boolean 


false 


AGAR LT AASB. |RSS ET ARTE, tnde L3 所 示 。 
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R13 布尔 值 的 逻辑 操作 


运算 符 名 称 
逻辑 与 


描 xk 
当 两 个 运算 数 均 为 true 时 ,结果 为 true; 
否则 为 false 

至 少 一 个 运算 数 为 true 时 ,结果 为 true; 
否则 为 false 


逻辑 或 


G) 字符 串 
字符 串 表 示 为 字符 序列 。 在 Kotlin 中 ， 字 符 串通 过 字符 串 类 表示 。 具 体 来 说 ， 字 符 
串 可 通过 双 引 号 以 及 其 中 的 字符 序列 加 以 定义 ， 如 下 所 示 : 


val martinLutherQuote: String = "Free at last, Free at last, Thank God 
almighty we are free at last." 
(6) 字符 


该 类 型 用 于 表示 字符 。 字 符 表示 为 一 个 信息 单位 ， 对 应 于 字形 或 符号 。 在 Kotlin H, 
字符 定义 为 Char 类 型 ， 并 通过 单 引号 表示 ， 例 如 '$'、'%' 和 '&'。 

val c: Char = 'i' // I am a character 

如 前 所 述 ， 字 符 串 可 表示 为 一 个 字符 序列 ， 如 下 所 示 ; 


var c: Char 
val sentence: String - "I am made up of characters." 


for (character in sentence) { 
c = character // Value of character assigned to c without error 
println (c) 
) 
CD 数组 
数组 表示 为 一 种 数据 结构 ， 并 由 元 素 或 数值 (包含 对 应 的 索引 或 键 ) 集合 构成 。 当 
存储 数据 元 素 集合 时 ， 数 组 十 分 有 用 ， 稍 后 即 会 在 程序 中 使 用 到 数组 。 
在 Kotlin 中 ， 数 组 使 用 arrayOfO 库 方法 加 以 构建 。 相 应 地 ， 数 组 中 的 存储 值 可 通过 
逗号 分 隔 的 序列 予以 传递 ， 如 下 所 示 : 


val names = arrayOf("Tobi", "Tonia", "Timi") 


每 个 数组 值 均 包含 唯一 的 索引 ， 用 于 指定 数组 中 的 位 置 ， 以 及 后 续 操作 中 的 数值 引 
用 。 另 外 ， 数 组 索引 始 于 索引 0， 并 逐一 递增 On D 。 
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数组 中 既定 索引 位 置 处 的 数值 , 可 通过 调用 Array#get0 方 法 或 [] 操 作 得 到 , 如 下 所 示 : 


val numbers = arrayOf(1, 2, 3, 4) 
println(numbers[0]) // Prints 1 
println(numbers.get(1)) // Prints 2 


另外 ， 还 可 对 某 一 数组 位 置 处 的 数值 加 以 修改 ， 如 下 所 示 : 


val numbers = arrayOf(1, 2, 3, 4) 
println(numbers[0]) // Prints 1 
numbers[0] = 23 
println(numbers[0]) // Prints 23 


利用 length 属性 ， 还 可 检测 数组 的 尺寸 ， 如 下 所 示 : 


val numbers = arrayOf(1, 2, 3, 4) 
println(numbers.length) // Prints 4 


4. 函数 
函数 表示 为 一 个 代码 块 ， 经 定义 后 即 可 重复 使 用 。 在 编写 程序 时 ， 较 好 的 方法 是 将 
复杂 的 程序 处 理 过 程 划分 为 较 小 的 单元 ， 并 执行 特定 的 任务 。 这 一 方式 涵盖 诸多 优点 ， 
其 中 包括 以 下 方面 : 
Q ”改善 代码 的 可 读 性 。 在 划分 为 较 小 的 函数 单元 后 ， 代 码 的 可 读 性 将 显著 提升 ， 
其 理解 范围 也 将 有 所 降低 。 大 多 数 时 候 ， 程 序 员 只 需要 编写 或 调整 一 个 大 型 代 
码 库 的 部 分 内 容 。 当 采用 函数 时 ， 需 要 读 取 程序 并 改进 程序 逻辑 的 上 下 文 环 境 ， 
仅 限 于 编写 对 应 逻辑 的 函数 体 中 。 
Q ”改进 代码 库 的 可 维护 性 。 使 用 代码 库 中 的 函数 可 便于 程序 的 维护 。 如 果 某 个 程 
序 功能 需要 修改 ， 那 么 ， 仅 须 调整 该 功能 所 处 的 函数 即 可 。 
(1) 函数 声明 
函数 的 声明 可 利用 fun 关键 字 加 以 实现 。 考 察 下 列 简单 的 函数 定义 
fun printSum(a: Int, b: Int) { 
print(a * b) 
) 
该 函数 简单 地 输出 两 个 数值 〈 作 为 参数 进行 传递 ) 之 和 。 函 数 定 义 包含 以 下 内 容 
O ”函数 标识 符 。 函 数 标识 符 表示 为 赋予 函数 的 名 称 。 如 果 和 希望 在 后 续 程序 操作 中 
调用 该 函数 ， 则 需要 利用 标识 符 引 用 该 函数 。 在 之 前 的 函数 声明 中 ，printSum 
表示 为 当前 函数 的 标识 符 。 
OQ ”包含 一 对 括号 中 以 逗号 分 隔 的 参数 列表 。 传 递 至 函数 中 的 数值 称 作 函 数 的 参数 。 
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传递 至 函数 中 的 所 有 参数 需要 定义 为 某 种 类 型 。 有 具体 类 型 位 于 冒号 之 后 。 
O ”返回 类 型 。 函 数 的 返回 类 型 确定 方式 与 变量 和 属性 类 似 。 也 就 是 说 ， 在 最 后 一 
个 括号 后 的 冒号 后 指定 相关 类 型 。 
Q ”函数 体 。 
不 难 发 现 ， 上 述 函 数 并 未 设置 返回 类 型 。 实 际 情况 并 非 如 此 ， 函 数 包含 了 一 个 Unit 返 
类 型 。Unit 返回 类 型 并 不 需要 显 式 地 予以 指定 。 上 述 函 数 也 可 采用 下 列 方式 进行 声明 ， 
fun printSum(a: Int, b: Int): Unit { 


print(a + b) 
) 


O +z. 

函数 并 非 总 是 需要 标识 符 。 不 包含 标识 符 的 函数 也 称 作 匿 名 函数 。 在 Kotlin P, [E 
名 函数 以 lambdas 这 一 形式 体现 

(2) 函数 调用 

函数 在 定义 完毕 后 并 未 予以 执行 。 对 此 ， 须 对 该 函数 加 以 调用 并 存在 多 种 调用 方式 。 
例如 ， 基 于 函数 、 方 法 的 直接 函数 调用 ;利用 invoke0 和 call0 方 法 的 间接 调用 。 下 列 代 
码 表示 为 基于 函数 自身 的 直接 函数 调用 。 


fun repeat(word: String, times: Int) ( 


I 


vari-0 


while (i < times) { 
println (word) 
ict 
) 
) 


fun main(args: Array<String>) { 
repeat ("Hello!", 5) 

) 

在 编译 并 运行 上 述 代码 后 ， 屏 幕 上 将 输出 “Hello!”5 次 。 这 里 ，“Hello!” 是 函数 
的 第 一 个 参数 ，5 则 是 第 二 个 参数 。 随 后 ，word 和 times 参数 在 repeat 函数 中 被 设置 为 
“Hello!” 和 5。 只 要 i 小 于 所 指定 的 times 值 ，while 循环 即 会 运行 并 输出 相关 内 容 。 同 
时 ，i++ 用 于 递增 i 值 (加 1) 。 在 每 次 循环 欠 代 过 程 中 ,i 值 将 加 1。 一旦 i 值 等 于 5， 则 
循环 终止 。 因 此 ，“Hello!” 将 被 输出 5 次 。 编 译 并 运行 当前 程序 将 输出 如 图 1.7 Bras 
结果 。 


返 


pu 


/kotlin by examples 


/kotlin_by_example# 


图 1.7 


(3) 
顾 名 思 
回 值 的 类 
fun returnFullName(firstName: Stri 


return "${firstName} ${surname}" 


} 


返回 值 
义 ， 返 回 值 表 示 方 法 返回 的 数值 。 
型 则 通过 函数 的 返回 类 


{ 


returnFul 


fun main(args: Array<String>) 
val fullName: String 
println(fullName) // prints: 
} 


在 上 述 代 码 中 ,retumFullName 函数 作为 
个 字符 串 。 相 应 地 ， 翻 译 类 型 在 函数 头 : 
成 ， 如 下 所 示 : 

'$(firstName) ${surname}" 

-个 名 称 值 和 最 后 
(4) 函数 命名 规则 
在 Kotlin 中 ， 函 数 的 命名 规则 与 Java 类 
母 采 用 大 写 形式 ， 且 不 包含 空格 和 标 
//Good function name 

fun sayHello() ( 


println ("Hello") 
) 


nr 


y 
3 


Ka 


Rt 


//Bad function name 


fun say hello() { 


“Hello!” 


-个 名 称 值 将 内 插 至 字符 


r WordRepeat 


将 被 输出 5 次 


Kotlin 中 的 函数 可 在 执行 时 返回 数值 。 函 数 


型 加 以 定义 ， 如 下 所 示 : 


ng, surname: String): String { 


lName ("James", "Cameron") 


James Cameron 


d 


输入 参数 接收 两 NFR, 并 在 被 调用 时 返 
中 加 以 定义 ;而 返回 的 字符 串 则 通过 字符 串 


串 中 。 


当 命 名 方法 时 ， 
如 下 所 示 : 


mo 


AU. 


T9. 


可 采用 驼峰 规则 一 一 
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printin("Hello") 
} 


5. 注释 

当 编写 代码 时 ， 可 能 需要 记录 与 代码 相关 的 一 些 信息 ， 这 可 通过 注释 予以 实现 。 在 
Kotlin 中 ， 存 在 以 下 3 种 注释 方式 : 
OQ 单行 注释 。 
口 多 行 注释 。 
口 文档 注释 。 
(1) 单行 注释 

顾名思义 ， 这 一 类 注释 只 占据 一 行 。 单 行 注释 始 于 //。 在 编译 过 程 中 ，// 之 后 的 全 部 
字符 均 被 忽略 。 考 察 下 列 代码 : 

val b: Int = 957 // This is a single line comment 

// println(b) 

由 于 执行 输出 操作 的 函数 已 被 注释 掉 ， 因 而 b 值 不 会 输出 至 控制 台中 。 

(2) 多 行 注释 

多 行 注释 将 占据 多 行 ， 并 以 /* 开 始 ， 以 */ 结 束 ， 如 下 所 示 : 

/* 

* I am a multiline comment. 

* Everything within me is commented out. 

ap 

(3) 文档 注释 

这 种 注释 类 型 与 多 行 注释 类 似 ， 主 要 的 差别 在 于 : 文档 注释 将 在 程序 中 记录 代码 。 
文档 注释 始 于 /** 并 以 */ 结 束 ， 如 下 所 示 : 


/** 


* Adds an [item] to the queue. 

* (return the new size of the queue. 
yl 

fun enqueue(item: Object): Int ( ... } 


6. 控制 程序 流 

在 编写 程序 时 ， 常 见 情形 是 控制 程序 的 执行 方式 。 当 根据 相关 条 件 或 程序 状态 制定 
角色 时 ， 处 理 控制 问题 将 十 分 必要 。 对 此 ，Kotlin 包含 了 多 种 结构 ,例如 为 人 们 所 熟悉 的 
if. while 和 for 结构 ;而 一 些 结构 则 是 Kotlin 特有 的 内 容 ， 例 如 when 结构 。 本 节 将 讨论 
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与 控制 流 相关 的 各 种 程序 结构 。 

(1) 条 件 表 达 式 

条 件 表 达 式 常用 于 程序 流 的 分 支 结构 ， 并 根据 条 件 测试 结构 执行 或 忽略 程序 语句 。 
这 里 ， 条 件 语句 可 视 作 程 序 的 决策 点 。 

Kotlin 包含 两 种 分 支 处 理 结 构 ， 即 让 表达 式 和 when 表达 式 。 

(2) if RER 

根据 条 件 判断 结果 ， 让 表达 式 用 于 制定 逻辑 决策 。 对 此 ， 可 利用 if REESE if K 
达 式 ， 如 下 所 示 : 


vala=1 


if (a == 1) { 
print("a is one") 


} 


ER 这 表达 式 测试 a 一 1 ( 读 作 a 等 于 1) 条 件 是 否 为 tue。 如 果 该 条 件 为 tue， 将 
在 屏幕 上 输出 字符 串 “ais one”; 否则 不 输出 任何 内 容 。 

让 表达 式 通常 会 包含 一 个 或 多 个 else 或 else 让 关键 字 ， 并 以 此 进一步 控制 程序 流 。 
考察 下 列 if KER: 

val a= 4 

if (a == 1) { 

print("a is equal to one.") 

} else if (a == 2) { 


print("a is equal to two.") 
) else ( 


print("a is neither one nor two.") 


} 


上 述 表 达 式 首先 测试 a 是 否 等 于 1， 该 测试 结果 为 false， 因 而 将 继续 测试 后 续 条 件 。 
第 二 个 条 件 表达 式 的 结果 也 为 false， 因 而 将 执行 最 后 一 条 语句 。 最 终 ， 屏 幕 上 将 输出 “a 
is neither one nor two" o 
(3) when 表达 式 
when 表达 式 则 是 另 一 种 程序 控制 方式 。 考 察 下 列 代码 以 查看 其 工作 方式 : 


fun printEvenNumbers (numbers: Array<Int>) { 
numbers.forEach { 
when (it $ 2) { 
0 -> printin(it) 
) 
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fun main (args: Array<String>) { 
val numberList: Array<Int> = arrayOf(1, 2, 3, 4, 5, 6) 
printEvenNumbers (numberList) 

) 


上 述 printEvenSum 函数 接收 一 个 整 型 数组 ， 并 将 其 作为 唯一 参数 。 本 章 稍 后 将 对 数组 
予以 介绍 ， 当 前 可 将 其 视 为 数值 序列 集合 。 在 该 示例 中 ， 所 传递 的 数组 包含 了 整数 空间 内 
的 数值 。 每 个 数组 元 素 通 过 forEach 方法 进行 遍历 ， 且 每 个 数字 在 when 表达 式 中 被 测试 。 

此 处 ，it 引用 了 forEach 方法 所 遍历 的 当前 值 。 另 外 ，% 运 算 符 表示 为 二 元 运算 符 ， 
并 对 两 个 运算 数 进行 计算 ， 即 第 一 个 运算 数 除 以 第 二 个 运算 符 ， 并 返回 除法 运算 后 的 余 
数 。 因 此 ，when 表 过 式 测 试 当前 遍历 值 是 否 〈 何 时 ) 被 2 除 且 余数 为 0。 若 是， 则 该 值 
为 偶数 且 输 出 至 屏幕 上 。 

为 了 进一步 查看 程序 的 工作 方式 ， 可 将 上 述 代码 复制 、 粘 贴 至 文件 中 ， 随 后 编译 并 
运行 该 程序 ， 对 应 结果 如 图 1.8 所 示 。 


图 1.8 when 表达 式 测试 


(4) Elvis 运算 符 
Elvis 运算 符 则 是 Kotlin 中 一 种 较为 简洁 的 结构 ， 如 下 所 示 : 


(expression) ?: value2 


下 列 代 码 显示 了 Elvis 运算 符 在 Kotlin 中 的 应 用 : 


val nullName: String? = null 
val firstName nullName ?: "John" 


如 果 nullName 中 的 值 不 为 null，Elvis 运算 符 将 返回 该 值 ， 否 则 返回 "John" 字 符 串 。 
因此 ，firstName 被 赋予 了 Elvis 运算 符 的 返回 值 。 
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T. 循环 

循环 语句 确保 代码 块 中 的 语句 集合 可 被 重复 执行 。 也 就 是 说 ， 循 环 操作 可 保证 程序 中 
的 多 条 语句 被 多 次 执行 。Kotlin 中 的 循环 结构 包含 for 循环 、while 循环 和 do.…while 循环 。 

(1) for 循环 

Kotlin 中 的 for 循环 遍历 提供 了 和 迭代 器 的 任意 对 象 , 并 与 Ruby 语言 中 的 for...in 循环 
KW. for 循环 包含 下 列 语法 形式 : 

for (obj in collection) ( .. } 

如 果 仅 包含 一 条 语句 ， 那 么 ，for 循环 中 的 块 结构 将 不 再 必需 。 这 里 ， 集 合 是 一 种 提 
供 迭 代 器 的 结构 类 型 。 考 察 下 列 程序 : 

val numSet = arrayOf(1, 563, 23) 

for (number in numSet) { 


println (number) 
) 


numSet 数组 中 的 每 个 值 将 被 当前 循环 所 遍历 , 并 被 赋予 变量 number 中 。 随 后 ,number 
将 被 输出 至 标准 系统 输出 窗口 中 。 
O «s. 

数组 中 的 每 个 数据 元 素 均 包含 一 个 索引 。 索 引 表 示 为 数组 中 数据 元 素 的 位 置 。 在 
Kotlin 中 ， 数 组 的 索引 以 0 开始 。 


如 果 和 希望 输出 每 个 数值 的 索引 《而 非 数值 本 身 ) ， 则 可 使 用 下 列 代码 ; 
for (index in numSet.indices) ( 
println (index) 
) 
另外 ， 还 可 指定 迭代 器 变量 的 类 型 ， 如 下 所 示 : 
for (number: Int in numSet) { 
println (number) 
} 
(2) while 循环 
只 要 满足 特定 的 条 件 ，while 循环 将 执行 块 结 构 中 的 指令 。while 循环 可 通过 关键 字 
while 标记 ， 对 应 形式 如 下 所 示 : 


while (condition) f .. } 
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与 for 循环 的 情况 一 样 ， 如 果 循 环 结构 中 仅 包 含 一 条 语句 ， 那 么 ， 块 结构 是 可 选 的 。 
在 while 循环 中 ， 当 满足 条 件 时 ， 块 结构 中 的 语句 将 被 重复 执行 。 考察 下 列 代码 : 


val names = arrayOf("Jeffrey", "William", "Golding", "Segun", "Bob") 


var i=0 


while (!names[i].equals("Segun")) { 
println("I am not Segun.") 
i++ 
} 
在 上 述 程序 中 ，while 循环 中 的 代码 块 将 被 执行 ， 并 输出 “Iam not Segun” , HEX} 
应 名 称 为 Segun。 当 遇 到 Segun 时 ， 循 环 将 终止 ， 且 不 输出 任何 内 容 ， 如 图 1.9 所 示 。 


图 1.9 while 循环 


(3) break 和 continue 关键 字 
通常 ， 当 声明 循环 时 ， 如 果 满 足 相 关 条 件 ， 则 需要 退出 循环 ， 或 者 开始 下 一 次 迭代 
过 程 ， 这 可 通过 break 和 continue 关键 字 实现 。 下 面 考察 一 些 相 关 示 例 。 打 开 Kotlin 脚本 
文件 ， 并 复制 下 列 代码 : 


data class Student (val name: String, val age: Int, val school: String) 


val prospectiveStudents: ArrayList<Student> = ArrayList() 
val admittedStudents: ArrayList<Student> = ArrayList() 


prospectiveStudents.add(Student("Daniel Martinez", 12, "Hogwarts")) 
prospectiveStudents.add(Student("Jane Systrom", 22, "Harvard")) 
prospectiveStudents.add(Student("Matthew Johnson", 22, "University of 
Maryland")) 

prospectiveStudents.add(Student("Jide Sowade", 18, "University of Ibadan")) 
prospectiveStudents.add(Student ("Tom Hanks", 25, "Howard University")) 
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for (student in prospectiveStudents) { 
if (student.age < 16) { 
continue 


) 
admittedStudents.add (student) 


if (admittedStudents.size >= 3) { 
break 
} 
} 


println(admittedStudents) 

上 述 程序 从 学 生 名 单 中 选取 被 录取 的 学 生 。 程 序 开始 处 定义 了 一 个 数据 类 ， 并 对 每 
名 学 生 的 数据 建 模 ;随后 创建 两 个 数组 列表 。 其 中 ， 一 个 数组 列表 加 载 学 生 信息 ， 以 供 
录取 使 用 ， 另 一 个 列表 中 则 用 于 加 载 已 被 录取 的 学 生 名 单 。 

随后 的 5 行 代码 负责 将 学 生 添加 至 列表 中 。 接 下 来 ， 将 声明 一 个 循环 用 于 遍历 列表 
中 的 全 部 学 生 。 如 果 学 生年 龄 小 于 16 岁 ， 循 环 将 跳 至 下 一 次 操作 。 也 就 是 说 ， 不 符合 年 


dE KREE 
龄 的 学 


生 不 予 录取 《因而 也 不 会 添加 至 录取 学 生 列 表 中 ) 。 

如 果 学 生 的 年 龄 大 于 或 等 于 16 岁 ， 则 被 添加 至 录取 列表 中 。 随 后 ， 利 用 让 表达 式 判 
断 录取 学 生 的 数量 是 否 大 于 或 等 于 3。 若 条 件 为 tue， 则 程序 跳出 当前 循环 且 和 迭代 过 程 结 
# 的 最 后 一 行 代 码 将 输出 列表 中 的 学 生 名 单 。 
运行 该 程序 ， 将 得 到 如 图 1.10 所 示 的 结果 。 


Matthew Johns 
ade, age-18, s 


rootüvultr:-/kotlin by examples 


图 1.10 输出 列表 中 的 学 生 名 单 


(4) do...while 循环 
do...while 循环 类 似 于 while 循环 ， 唯 一 的 不 同 之 处 在 于 ， 循 环 的 条 件 测 试 在 第 一 次 
循环 迭代 之 后 进行 ， 对 应 形式 如 下 所 示 : 
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) while (condition) 


当 条 件 测试 为 rue 时 ， 代 码 块 中 的 语句 再 次 被 执行 ， 如 下 所 示 : 


var i=0 

do ( 

println("I'm in here!") 
HELD 


) while (i « 10) 


println("I'm out here!") 


NullPointerException 是 每 一 名 Java 程序 员 都 会 遇 到 的 情况 。Kotlin 类 型 系统 具备 空 
安全 特性 ， 并 试图 在 代码 中 消除 空 引用 的 出 现 。 相 应 地 ，Kotlin 支持 可 空 类 型 以 及 非 空 类 
型 〈 即 是 否 可 加 载 null 值 相关 类 型 ) 。 
为 了 清晰 地 解释 NullPointerException， 考 察 下 列 Java 程序 


class NullPointerExample { 


public static void main(String[] args) { 
String name - "James Gates"; 
System.out.println(name.length()); // Prints 11 


name - null; // assigning a value of null to name 
System.out.println(name.length()); // throws NullPointerException 
} 
} 


上 述 程序 向 标准 系统 输出 窗口 输出 字符 串 变 量 的 长 度 。 当 编译 并 运行 该 程序 时 ， 将 
抛 出 空 指针 异常 ， 执 行 过 程 将 中 途 停止 ， 如 图 1.11 所 示 。 


图 1.11 空 指针 异常 
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读者 是 否 可 尝试 解释 NullPointerException 出 现 的 原因 ? XE, String#length 方法 包 


含 了 空 引用 ， 因 此 ， 程 序 将 终止 执行 并 抛 出 异常 。 显 然 ， 这 并 不 是 我 们 所 期 望 的 结果 。 

在 Kotlin 中 ， 可 防止 向 name 对 象 赋予 null 值 ， 如 下 所 示 : 

var name: String - "James Gates" 

println (name. length) 

name = null // null value assignment not permitted 

println (name. length) 

在 图 1.12 中 ，Kotlin 类 型 系统 检测 到 将 null 值 赋予 name 对 象 ， 并 提示 程序 员 了 予以 
修正 。 

图 1.12 Kotlin 类 型 系统 检测 到 将 null 值 赋予 name 对 象 

此 时 ， 读 者 可 能 会 想 ， eed 算 传递 null 值 ， 情 况 又 当 如 何 ? 相应 地 ， 程 序 
员 可 向 变量 类 型 添加 一 个 “?”， 变量 值 声明 为 可 空 类 型 ， 如 下 所 示 : 

var name: String? = "James" 


println (name.length) 


name - null // null value assignment permitted 
println (name.length) 


尽管 变量 name 声明 为 可 空 类 型 ， 在 运行 上 述 程序 时 依然 会 出 现 错误 ， 其 原因 在 于 : 
需要 以 一 种 安全 的 方式 访问 变量 的 属性 ltngth， 这 可 通过 “?.” 加 以 实现 ， 如 下 所 示 : 


var name: String? - "James" 
println(name?.length) 


name - null // null value assignment permitted 
println(name?.length) 
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在 使 用 了 “?.” 安 全 操作 符 后 ， 程 序 则 按照 所 期 望 的 要 求 运行 ， 且 不 会 再 抛 出 空 指针 
异常 。 类 型 系统 意识 到 ， 此 时 引用 了 空 指针 ， 并 禁止 调用 空 对 象 上 的 length0 方 法 。 类 型 
到 1.13 所 示 。 


安全 输出 内 容 如 图 1 


图 1.13 类 型 安全 输出 
“?.” 安 全 操作 符 的 替代 方案 则 是 使 用 “ 凯 ” 操 作 符 。“ 山 ”操作 符 使 得 程序 员 可 继 
续 执 行程 序 ， 一 旦 函数 调用 在 空 引 用 上 进行 ， 则 会 抛 出 KotlinNullPointerException. 
我 们 可 以 进一步 考察 替换 后 的 效果 。 图 1.14 显示 了 程序 的 输出 结果 。 当 使 用 “!!” 
操作 符 时 ， 将 抛 出 KotlinNullPointerException 。 


ttin_by_exampte# kotlinc -script 


图 1.14 抛 出 KotlinNullPointerException 


8. 数据 包 
数据 包 表 示 为 相关 类 、 接 口 、 枚 举 、 注 解 和 函数 的 逻辑 分 组 。 随 着 源 文 件 不 断 增加 ， 
有 必要 将 这 些 文件 整合 至 相关 集合 中 ， 从 而 可 提升 应 用 程序 的 可 维护 性 ， 防 止 命名 冲突 ， 


并 实现 更 好 的 访问 控制 。 
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数据 包 可 利用 package 关键 字 以 及 随后 的 包 名 称 加 以 创建 ， 如 下 所 示 : 

Package foo 

每 个 程序 文件 只 能 有 一 个 数据 包 语句 。 如 果 没 有 指定 程序 文件 的 数据 包 ， 则 将 文件 
的 内 容 放 入 默认 包 中 。 

通常 情况 下 ， 程 序 员 需要 使 用 到 所 声明 数据 包 外 部 的 其 他 类 和 类 型 ， 这 可 通过 导入 
数据 包 资 源 予以 实现 。 如 果 两 个 类 属于 同一 个 数据 包 ， 则 不 需要 进行 额外 的 导入 工作 ， 
如 下 所 示 : 


package animals 
data class Buffalo(val mass: Int, val maxSpeed: Int, var isDead: Boolean = 
false) 


在 下 列 代码 片段 中 ， 类 并 不 需要 被 导入 当前 程序 中 ， 该 类 与 Lion 类 处 于 同一 个 数据 
包 (animals) ， 如 下 所 示 : 


package animals 
class Lion(val mass: Int, val maxSpeed: Int) ( 


fun kill(animal: Buffalo) ( // Buffalo type used with our import 
if (!animal.isDead) ( 
println("Lion attacking animal.") 
animal.isDead - true 
println("Lion kill successful.") 
) 
) 
) 


当 导 入 独立 包 中 的 类 、 函 数 、 接 口 以 及 类 型 时 ， 须 使 用 import 关键 字 ， 随 后 是 相应 
的 包 名 。 例 如 ， 下 列 main 函数 存在 于 默认 包 中 。 因 此 ， 如 果 需 要 使 用 到 main 函数 中 的 
Lion 类 和 Buffalo 类 ， 需 要 通过 import 关键 字 对 其 进行 导入 ， 如 下 所 示 : 


import animals.Buffalo 
import animals.Lion 


fun main(args: Array<String>) { 
val lion - Lion(190, 80) 
val buffalo - Buffalo(620, 60) 
println("Buffalo is dead: ${buffalo.isDead}") 
lion.kill (buffalo) 
println("Buffalo is dead: ${buffalo.isDead}") 
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1.2.2 面向 对 象 程序 设计 


截至 目前 ， 前 述 内 容 已 在 多 个 示例 中 使 用 到 了 类 这 一 概念 ， 但 尚未 对 此 予以 详细 讨 
论 。 本 节 将 介绍 类 以 及 Kotlin 中 其 他 的 面向 对 象 结构 。 

1. 简介 

在 高 级 程序 设计 语言 面世 之 初 ， 程 序 均 采用 面向 过 程 方式 加 以 编写 ， 其 中 采用 了 一 
系列 的 定义 良好 的 结构 化 步骤 编写 程序 。 

随 着 软件 产业 的 不 断 发 展 ， 计 算 机 程序 也 越 加 庞大 ， 因 而 有 必要 设计 一 种 更 优 的 方 
案 以 解决 软件 设计 问题 。 因 此 ， 面 向 对 象 程序 设计 语言 应 运 而 生 。 

面向 对 象 语言 围绕 对 象 和 数据 组 织 模块 ， 而 不 再 是 动作 以 及 序列 逻辑 。 在 面向 对 象 
程序 设计 语言 中 ， 实 现 了 对 象 、 类 和 接口 的 编写 、 扩 展 和 继承 机 制 ， 以 打造 工业 级 别 的 


软件 产品 。 
类 是 一 个 可 修改 和 可 扩展 的 程序 模板 ， 用 于 创建 对 象 ， 并 通过 变量 、 常 量 和 属性 来 
维护 状态 。 


类 中 一 般 定义 了 特征 和 行为 。 这 里 ， 特 征 体 现 为 变量 ， 而 行为 则 以 方法 的 形式 予以 
实现 。 其 中 ， 方 法 表示 为 特定 于 某 个 类 或 者 类 集合 的 函数 ， 同 时 ， 类 具有 从 其 他 类 继承 
特征 和 行为 的 能 力 ， 这 种 能 力 称 作 继 承 。 

Kotlin 是 一 种 完全 面向 对 象 的 程序 设计 语言 ， 并 支持 面向 对 象 语言 的 全 部 特性 。 在 
Kotlin 中 ， 仅 支持 单 继承 机 制 ， 这 一 点 与 Java 和 Ruby 保持 一 致 。 某 些 语言 ， 例 如 CH, 
则 支持 多 重 继承 。 多 重 继承 的 一 个 副作用 是 管理 问题 ， 例 如 名 称 冲突 问题 。 另 外 ， 继 承 
自 其 他 类 的 类 称 作 子 类 ， 而 所 继承 的 类 则 称 作 超 类 。 

作为 一 种 结构 ， 接 口 则 需要 强制 执行 类 中 的 特征 和 行为 。 基 于 接口 的 行为 强制 操作 
其 实现 可 描述 为 : 在 某 个 类 中 实现 接口 。 另 外 ， 接 口 也 可 扩展 为 另 一 个 接口 ， 这 一 点 与 
类 结构 类 似 。 

最 后 ， 对 象 则 表示 为 类 实例 ， 其 中 包含 了 自身 的 唯一 状态 。 

2. 与 类 协同 工作 

类 可 通过 class 关键 字 加 以 声明 ， 并 于 随后 附 以 类 名 ， 如 下 所 示 : 


class Person 


与 之 前 示例 程序 类 似 ， 类 也 需要 相应 的 代码 体 。 其 中 设置 了 相关 特征 和 行为 。 类 体 
可 通过 花 括 号 实现 ， 如 下 所 示 : 
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class HelloPrinter { 
fun printHello() ( 
println("Hello!") 
} 
} 
在 上 述 代码 片段 中 ， 类 命名 为 HelloPrinter， 其 中 声明 了 一 个 函数 。 相 应 地 ， 声 明 
于 类 中 的 函数 称 作 方 法 ， 也 称 作 行为 。 当 方法 声明 完毕 后 ， 即 可 被 所 有 的 类 实例 加 以 
使 用 。 
3. 生成 对 象 
声明 类 实例 或 者 对 象 实例 ) 与 变量 的 声明 十 分 类 似 。 下 列 代 码 生 成 了 一 个 
HelloPrinter 类 实例 : 


val printer = HelloPrinter() 


iX B, printer 表示 为 HelloPrinter 类 实例 。HelloPrinter 类 名 后 的 括号 用 于 调用 
HelloPrinter 类 的 主 构造 方法 。 其 中 ， 构 造 方法 类 似 于 一 个 函数 ， 但 用 于 初始 化 某 个 类 型 
的 对 象 。 

HelloPrinter 类 中 声明 的 函数 可 直接 通过 printer 对 象 调用 ， 如 下 所 示 : 


printer.printHello() // Prints hello 


少数 情况 下 ， 可 能 需要 函数 直接 从 类 中 调用 ， 且 不 需要 创建 一 个 对 象 。 对 此 ， 可 使 
用 伴生 对 象 。 


4. 伴生 对 象 


通过 关键 字 companion 和 object， 可 在 类 中 声明 伴生 对 象 。 随 后 ， 即 可 使 用 伴生 对 象 
中 的 静态 函数 ， 如 下 所 示 : 
class Printer { 
companion object DocumentPrinter { 
fun printDocument() = println("Document printing successful.") 


} 
} 


fun main(args: Array<String>) { 
Printer.printDocument() // printDocument() invoked via companion object 
Printer.Companion.printDocument() // also invokes printDocument () 
//via a companion object 
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某 些 时 候 ， 需 要 对 伴生 对 象 设置 一 个 标识 符 。 对 此 ， 可 将 具体 名 称 放置 于 object X 
键 字 之 后 。 考 察 下 列 示例 : 
class Printer ( 
companion object DocumentPrinter { // Companion object identified by 
DocumentPrinter 


fun printDocument() = println("Document printing successful.") 


} 
} 


fun main(args: Array<String>) { 
Printer.DocumentPrinter.printDocument() // printDocument() invoked via 
// a named companion object 


} 


5. 属性 
类 中 可 定义 属性 , 并 通过 var 和 val 关键 字 加 以 声明 。 例 如 ,在 下 列 代码 片段 中 , Person 
类 包含 了 3 个 属性 ， 即 age、firstName 和 surname. 


class Person { var age = 0 
var firstName - "" 


) 

属性 可 通过 类 实例 加 以 访问 ， 对 应 操作 方式 为 : 实例 标识 符 +“.”+ 属 性 名 。 例 如 ， 
在 下 列 代码 片段 中 ， 创 建 了 Person 类 实例 (名 为 person) ， 并 通过 访问 相关 属性 ， 向 
firstName, surname 和 age 属性 赋值 。 


val person = Person() 
person.firstName = "Raven" 
person.surname - "Spacey" 
person.age = 35 


13 Kotlin 的 优点 


如 前 所 述 ，Kotlin 旨 在 设计 成 一 个 更 好 的 Java， 因 而 与 Java HEC, Kotlin 的 优势 了 
要 体现 在 以 下 几 方 面 : 
O uU. NullPointerException 常 出 现 于 Java 中 , 通过 空 安 全 类 型 系统 ，Kotlin 


Ht 
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在 一 定 程度 上 缓解 了 这 一 问题 。 

OD “扩展 函数 。 函 数 可 更 方便 地 添加 至 类 中 ， 并 可 通过 多 种 方式 扩展 各 项 功能 ， 旧 
Kotlin 中 的 扩展 函数 。 

O FHER. Æ Kotlin 程序 中 ， 可 更 加 方便 地 实现 单 例 模式 ， 而 Java 在 这 一 方面 
则 表现 得 较为 烦琐 。 

Q ”数据 类 。 当 编写 程序 时 , 一 种 常见 的 情形 是 定义 一 个 类 ， 其 唯一 功能 是 加 载 数据 ， 
而 这 一 枯燥 的 工作 常会 涉及 大 量 代码 。Kotlin 的 数据 类 则 简化 了 这 项 操作 一 一 创 
建 加 载 数据 的 类 仅 须 编写 一 行 代码 。 

口 ” 函 数 类 型 。 与 Java 不 同 ，Kotlin 包含 函数 类 型 ， 这 也 使 得 函数 可 作为 参数 接收 

一 个 函数 ， 同 时 也 可 返回 一 个 函数 。 


1.4 利用 Kotlin 开发 Android 应 用 程序 


前 述 内 容 对 Kotlin 所 体现 的 一 些 强大 功能 进行 了 简要 的 分 析 。 在 接 下 来 的 章节 中 ， 
我 们 将 探讨 如 何在 Android 应 用 程序 开发 中 使 用 这 些 特性 一 一 这 也 是 Kotlin 的 一 个 亮点 。 
下 面 首 先 对 当前 任务 设置 相关 系统 。 开 发 Android 应 用 程序 的 一 个 主要 的 需求 是 获得 
一 个 合适 的 IDE 一 一 虽然 这 并 非 必需 ， 但 会 简化 开发 过 程 。 对 此 存在 多 种 选择 方案 ， 其 
中 最 受 欢 迎 的 IDE 包括 以 下 几 款 
DD Android Studio. 
Q Eclipse. 
QO IntelliJ IDE. 
对 于 Android FFA Ki, Android Studio 则 是 一 款 功 能 最 为 强大 的 IDE。 本 书 所 涉及 
的 与 Android 相关 的 内 容 均 采 用 Android Studio。 


1.4.1 设置 Android Studio 


在 本 书 编写 时 ，Android Studio 3.0 为 当前 最 新 版 本 ， 并 附带 完整 的 Kotlin 支持 。 

读者 可 访问 https://developer.android.com/studio/preview/index.html， 以 下 载 Android 
Studio 3.0 的 Canary AS. 在 下 载 完毕 后 ， 可 打开 下 载 包 或 可 执行 文件 ， 并 遵循 相关 的 安 
装 指令 。 其 间 ， 安 装 向 导 可 指导 用 户 完成 安装 步骤 ， 如 图 1.15 所 示 。 

随后 将 提示 用 户 选择 Android Studio 配置 类 型 ， 如 图 1.16 所 示 。 
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Welcome 


L^ unu 


图 1.15 Android Studio 安装 向 导 


& Android Studio 


网 Install Type 


Choose the type of setup you want for Android Studio: 


O Sundard 
‘Android Studio wil be Installed with the most common settings and options, 


图 1.16 Android Studio 配置 类 型 
接 下 来 ， 选 择 Standard 配置 项 ， 在 随后 的 操作 中 单 击 Verify Settings 窗口 上 的 Finish 
按钮 。 此 时 ，Android Studio 将 下 载 配置 所 需 的 组 件 ， 在 下 载 过 程 中 ， 读 者 须 稍 作 等 待 ， 
如 图 1.17 所 示 。 
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Android Studio Dj 2G) oox 画 ，Fi756pPM Q @ = 


. ‘Android Studio Setup wizard 


Gx Downloading Components 


图 1.17 下 载 配置 所 需 的 组 件 


待 组 件 下 载 完毕 后 ， 单 击 Finish 按钮 。 接 下 来 将 显示 开始 界面 ， 并 可 使 用 Android 
Studio， 如 图 1.18 所 示 。 


Android Studio 


Version 3.0 Canary 9 (171.4220116) 


© Start a new Android Studio project 

& Open an existing Android Studio project 

$ Check out project from Version Control + 
[€ Profile or debug APK 

1€ Import project (Gradle, Eclipse ADT, etc.) 
uf Import an Android code sample 


X* Configure ~ Get Help ~ 


图 1.18 登录 界面 
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1.4.2 ”构建 第 一 个 Android 应 用 程序 


下 面 讨论 如 何 利 用 Android Studio 创建 简单 的 Android 应 用 程序 , BI HelloApp。 该 应 
用 程序 在 单 击 相关 按钮 后 将 在 屏幕 上 显示 “Hello World!”。 

在 Android Studio 的 开始 界面 中 ， 单 击 Start a new Android Studio project， 进 而 配置 
与 App 相关 的 某 些 细节 内 容 ， 例 如 应 用 程序 名 称 、 公 司 域 名 以 及 项 目 所 处 位 置 。 如 果 尚 
无 公司 域名 ， 可 在 公司 域名 输入 框 中 填写 任何 有 效 的 域名 。 当 前 项 目 仅 供 展示 使 用 ， 因 
而 暂 不 需要 使 用 合法 的 域名 。 

另外 ， 还 需要 设置 项 目的 保存 位 置 ， 同 时 选中 复 选 框 以 包含 Kotlin 支持 。 

在 参数 填写 完毕 后 ， 随 后 将 显示 如 图 1.19 所 示 的 窗口 ， 即 Target Android Devices。 


7X Target Android Devices 


Select the form factors and minimum SDK 
Some devices require additional SDKs. Low API levels target more devices, but offer fewer API features. 


Phone and Tablet 
API 15: Android 4.0.3 (IceCreamSandwich) 


By targeting API 16 and later, your app will run on approximately 100% of devices. Help me choose 
C Wear 

API 21: Android 5.0 (Lollipop) B 
mh, 

API 21: Android 5.0 (Lollipop) B 
[ Android Auto 
口 Android Things 

API 24: Android 7.0 (Nougat) B 


_Previous _ _Finish_ 


图 1.19 Target Android Devices 窗口 
这 里 需要 指定 目标 设备 。 考 虑 到 当前 应 用 程序 运行 于 智能 手机 设备 上 ， 因 而 可 选中 
Phone and Tablet 复 选 框 。Phone and Tablet 下 方 是 一 个 选项 下 拉 菜 单 ， 用 于 指定 所 建 项 目 
的 目标 API 级 别 (level) 。 此 处 ，API 级 别 表示 为 一 个 整数 ， 用 于 唯一 标识 Android 平台 
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所 提供 的 框架 API 版 本 。 此 处 选择 API level 15 并 进入 下 一 个 窗口 ， 即 Add an Activity to 
Mobile 窗口 ， 如 图 1.20 所 示 。 


e^o Create New Project 


x Add an Activity to Mobile 


Add No Activity 
Bottom Navigation Activity 
9 = 


Cancel Previous | QE (Finish | 
图 1.20 Add an Activity to Mobile 窗口 

在 下 一 个 窗口 中 ， 需 要 选择 一 个 活动 〈activity) 并 添加 至 当前 应 用 程序 中 。 这 里 ， 
活动 是 包含 了 唯一 用 户 界面 的 单一 画面 一 一 类 似 于 一 个 窗口 。 第 2 章 将 对 此 了 予以 详细 介 
绍 。 当 前 ， 可 选择 空 活 动 并 进入 下 一 个 窗口 。 

接 下 来 需要 配置 所 指定 的 活动 ， 并 将 其 命名 为 HelloActivity， 同 时 确保 选中 Generate 
Layout File 和 Backwards Compatibility 复 选 框 ， 如 图 1.21 所 示 。 
单 击 Finish 按钮 后 ， 稍 作 等 待 后 即 完 成 项 目的 设置 。 

当 设 置 结束 后 ， 即 可 看 到 包含 了 项 目 文件 的 IDE 窗口 。 
Oe: 

在 项 目 开 发 期 间 ， 常 会 遇 到 与 缺少 必要 的 项 目 组 件 相关 的 错误 。 对 此 ， 可 通过 SDK 
管理 器 进行 下 载 。 
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wR Configure Activity 


Creates a new empty activity 


Activity Name 


HelloActivity 


© Generate Layout File 


Layout Name 


activity hello 


© Backwards Compatibility (AppCompat) 


The name of the activity class to create 


Cancel Previous 
图 1.21 配置 活动 
确保 已 经 打开 了 IDE 的 项 目 窗口 〈 在 导航 栏 上 选择 View | Tool Windows 


Project (i 


4 ; [HIM Android 视图 当前 已 从 下 拉 列 表 〈 位 于 Project 窗口 上 方 ) 中 被 选取 。 随 后 


将 会 看 到 窗口 左 侧 中 的 相关 文件 ， 如 下 所 示 。 


Q “app | java | com.mydomain.helloapp | HelloActivity.java: 即 应 用 程序 的 主 活动 。 当 


构建 并 运行 应 用 程序 时 ， 系 统 将 生成 该 活动 实例 。 


Qd app | res | layout | activity hello.xml: HelloActivity 用 户 界面 定义 于 该 XML 文件 
中 ， 其 中 包含 了 置 于 ConstraintLayout 的 ViewGroup 中 的 TextView 元 素 。 


TextView 的 文本 内 容 被 设置 为 “Hello World!”。 


口 app | manifests | AndroidManifest.xml: AndroidManifest 文件 用 于 描述 应 用 程序 的 


基本 特征 。 除 此 之 外 ， 该 文件 中 还 定义 了 应 用 程序 的 组 件 。 


Q Gradle Scripts | build.gradle: 当前 项 目 中 显示 了 两 个 build.gradle 文件 。 


其 中 , 第 


一 个 build.gradle 文件 用 于 当前 项 目 ; 第 二 个 build.gradle 文件 则 用 于 应 用 程序 组 


件 的 build.gradle 文件 。 


TF. MF Grade 工具 的 编译 过 程 配 置 ， 以 及 应 用 程序 的 构建 ， 一 般 常会 用 到 组 
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Os. 
Gradle 是 一 个 开源 的 构建 自动 化 系统 ， 用 于 项 目 配置 的 声明 。 在 Android 'P, Gradle 
用 作 构 建 工 具 ， 旨 在 构建 数据 包 以 及 管理 应 用 程序 间 的 依赖 关系 。 


1. 构建 用 户 界 面 


用 户 界面 UI》 是 用 户 与 应 用 程序 交互 的 主要 方式 。Android 应 用 程序 的 用 户 界面 
可 通过 创建 、 操 控 布 局 文件 予以 实现 。 这里, 布局 文件 是 位 于 app | res | layout 中 的 XML 
文件 。 
当 对 HelloApp 构建 布局 文件 时 ， 需 要 执行 以 下 3 个 步骤 : 
(1) 向 布局 文件 中 添加 LinearLayout。 
(2) 将 TextView 置 于 LinearLayout 中 ， 并 移出 所 包含 的 android:text 属性 。 
(3) 向 LinearLayout 中 添加 一 个 按钮 。 
打开 activity hello.xml 文件 ， 随 后 将 显示 布局 编辑 器 。 如 果 该 编辑 器 位 于 Design 视 
图 中 ， 可 将 其 调整 至 Text 视图 中 ， 即 切换 布局 编辑 器 下 方 的 选项 。 当 前 ， 布 局 编辑 器 如 
图 1.22 所 示 。 
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图 1.22 布局 编辑 器 
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LinearLayout 表示 为 一 个 ViewGroup， 并 以 单列 形式 在 水 平 或 垂直 方向 上 排列 子 视 
图 。 读 者 可 从 下 列 代码 块 中 复制 所 需 的 LinearLayout 代码 片段 ， 并 将 其 粘贴 到 TextView 
之 前 的 ConstraintLayout 中 。 


<LinearLayout 
android:id="@+id/1l component container" 
android:layout width="match parent" 
android:layout height-"match parent" 
android:orientation-"vertical" 
android:gravity-"center"» 
</LinearLayout> 


此 处 ， 将 activity hello.xml 文件 中 的 TextView 粘贴 至 LinearLayout 元 素 中 ， 并 移 除 
android:text 属性 ， 如 下 所 示 : 


<LinearLayout 
android:id-"8*id/11 component container" 
android:layout width-"match parent" 
android:layout height-"match parent" 
android:orientation-"vertical" 
android:gravity-"center"» 

<TextView 
android:id="@tid/tv_greeting" 
android: layout_width="wrap_ content" 
android:layout height="wrap content" 
android:textSize-"50sp" /> 

</LinearLayout> 


最 后 ， 还 需要 向 布局 文件 中 添加 按钮 元 素 ， 该 元 素 为 LinearLayout 的 子 元 素 。 当 创 
一 个 按钮 时 ， 可 使 用 Button 元 素 ， 如 下 所 示 : 


<LinearLayout 
android:id="@+id/1l component container" 
android:layout width-"match parent" 
android:layout height-"match parent" 
android:orientation-"vertical" 
android:gravity-"center"» 

<TextView 
android:id="@tid/tv greeting" 
android:layout width="wrap content" 
android:layout height-"wrap content" 
android:textSize-"50sp" /» 
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<Button 
android:id="@+id/btn click me" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android: layout_marginTop="16dp" 
android:text="Click me!"/> 
</LinearLayout> 


切换 到 布局 编辑 器 的 设计 视图 ， 当 显示 用 户 界面 时 ， 即 可 查看 到 内 容 的 变化 方式 ， 
如 图 1.23 所 示 。 


HelloApp 


图 1.23 显示 用 户 界面 ， 并 显示 内 容 的 变化 方式 
当前 布局 仍 存 在 一 个 问题 ， 当 单 击 “CLICK ME!” 按 钮 时 ， 该 按钮 并 未 执行 任何 操 
作 。 对 此 ， 可 向 该 按钮 添加 单 击 事件 监听 器 。 打 开 HelloActivity.java 文件 ， 编 辑 函 数 ， 
针对 “CLICK ME!” 按 钮 的 单 击 事件 添加 相关 逻辑 ， 并 导入 所 需 的 数据 包 。 对 应 代码 如 
下 所 示 : 


package com.mydomain.helloapp 


import android.support.v7.app.AppCompatActivity 
import android.os.Bundle 

import android.text.TextUtils 

import android.widget.Button 
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import android.widget.TextView 
import android.widget.Toast 


class HelloActivity : AppCompatActivity() ( 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate (savedInstanceState) 
setContentView(R.layout.activity hello) 
val tvGreeting = findViewById<TextView>(R.id.tv greeting) 
val btnClickMe = findViewById«Button» (R.id.btn click me) 
btnClickMe.setOnClickListener ( 
if (TextUtils.isEmpty(tvGreeting.text)) { 
tvGreeting.text = "Hello World!" 
} else { 
Toast.makeText (this, "I have been clicked!", 
Toast.LENGTH_LONG) . show () 
} 
} 
} 
} 


在 上 述 代码 片段 中 ， 通 过 使 用 findViewById 函数 ， 我 们 在 activity hello 布局 文件 中 
添加 了 对 TextView 和 Button 元 素 的 引用 。findViewById 函数 可 用 于 获取 指向 布局 元 素 的 
引用 ， 此 类 元 素 位 于 当前 所 设置 的 内 容 视图 中 。onCreate 函数 的 第 二 行 代 码 将 
HelloActivity 的 内 容 视图 设置 为 activity hello.xml 布局 。 

在 findViewByld 函数 右 侧 ， 是 位 于 尖 括 号 中 的 TextView 类 型 ,这 称 作 函数 泛 型 ， 并 
强制 传递 至 findViewById 的 资源 ID 隶属 于 一 个 TextView 元 素 。 

在 添加 了 引用 对 象 后 ， 可 将 onClickListener 设置 为 btnClickMe。 监 听 器 用 于 应 用 程 
序 中 所 出 现 的 事件 。 为 了 在 元 素 的 单 击 操作 上 执行 某 个 动作 ， 可 将 包含 所 执行 动作 的 
lambda 传递 至 元 素 的 setOnClickListener 方法 中 。 

当 单 击 btnClickMe Ja, 将 检测 tvGreeting 并 查看 是 否 已 设置 为 包含 相关 的 文本 内 容 。 
WIR TextView 未 被 设置 文本 内 容 ， 那 么 ， 对 应 的 文本 将 设置 为 “Hello World!”; 和 否则， 
将 显示 包含 “Ihave been clicked!” 文 本 的 提示 框 。 

2. 运行 应 用 程序 

当 运行 应 用 程序 时 ， 可 单 击 IDE 窗口 右上 方 的 Run 'app' (^R) 按 钮 ， 并 选择 一 个 部 署 
目标 。 随 后 ，HelloApp 将 在 部 署 目标 上 被 构建 、 安 装 和 运行 ， 如 图 1.24 所 示 。 
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图 1.24 构建 、 安 装 和 运行 HelloApp 


读者 可 使 用 某 种 预 置 虚拟 设备 或 创建 自 定义 虚 拟 设备 ， 进 而 将 其 用 作 部 署 目标 。 除 
此 之 外 ， 还 可 将 物理 Android 设备 通过 USB 连接 至 计算 机 上 ， 并 将 其 选 作 部 署 目标 。 具 
体 选择 方案 取决 于 读者 。 在 选取 了 部 署 设备 后 ， 单 击 OK 按钮 即 可 构建 、 运 行当 前 应 用 
程序 。 

运行 应 用 程序 后 ， 读 者 即 可 看 到 所 创建 的 布局 效果 ， 如 图 1.25 所 示 。 
单 击 “CLICK ME!” 后 ， 将 显示 “Hello World!”， 如 图 1.26 所 示 。 


HelloApp HelloApp 


Hello World! 


CLICK ME! 


图 1.25 所 创建 的 布局 效果 图 1.26 显示 “Hello World!” 


连续 单 击 “CLICK ME!” 按 钮 将 显示 “I have been clicked!” 文 本 提示 消息 ， 如 图 1.27 
所 示 。 
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HelloApp 


Hello World! 


CLICK ME! 


Ihave been clicked! 


图 1.27 Si; “CLICK ME!” 按 钮 将 显示 “Ihave been clicked!” 文 本 提示 消息 
1.5 Web 基础 知识 


大 多 数 应 用 程序 都 会 以 某 种 方式 与 服务 器 通信 。 在 阅读 后 续 章 节 之 前 ， 读 者 需要 了 
解 一 些 与 Web 相关 的 概念 ， 本 节 将 对 此 了 予以 简要 介绍 。 
1.5.1 Web 的 含义 


Web 是 一 个 复杂 的 系统 ， 通 过 一 个 或 多 个 协议 ， 可 与 公共 网 络 上 的 其 他 系统 进行 通 
信 。 相 应 地 ， 协 议 是 管理 设备 间 信 息 交 换 的 正式 的 、 定 义 良 好 的 规则 系统 。 


1.5.2 ” 超 文 本 传输 协议 


Web 上 的 所 有 通信 都 是 按照 协议 进行 的 。 对 此 ， 超 文本 传输 协议 CHITP) 是 一 个 特 
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别 重 要 的 、 用 于 实现 系统 间 通 信 的 协议 。 

数 十 亿 的 图 像 、 视 频 、 文 本 文件 、 文 档 和 其 他 文件 每 天 都 在 互联 网 上 传输 ， 这 些 文 
件 都 是 通过 HTTP 传输 的 。HTTP 是 分 布 式 和 超 媒体 信息 系统 的 应 用 协议 。 可 以 说 ， 它 是 
跨 互 联网 通信 的 一 个 基本 组 成 部 分 。 可 靠 性 是 使 用 HTTP 进行 跨 系统 数据 传输 的 一 个 主 
要 优点 ， 其 原因 在 于 使 用 了 可 靠 的 协议 ， 如 传输 控制 协议 CTCP) 和 互联 网 协议 CIP) 。 


1.5.3 ”客户 端 和 服务 器 


Web 客户 端 是 使 用 HTTP 与 Web 服务 器 通信 的 应 用 程序 ; 而 Web 服务 器 则 是 为 Web 
客户 端 提供 (或 服务 于 ) Web 资源 的 计算 机 设备 。 任 何 可 提供 Web 内 容 的 数据 形式 均 可 
视 为 Web 资源 。Web 资源 可 以 是 媒体 文件 、 HTML 文档 、 网 关 等 。 客 户 端 须 通过 Web 
内 容 实 现 各 种 功能 ， 如 信息 呈现 和 数据 操作 。 

客户 端 和 服务 器 通过 HTTP 进行 通信 。 使 用 HTTP 的 一 个 主要 原因 是 它 在 数据 传输 
中 非常 可 靠 。HTTP 的 使 用 可 确保 在 请 求 -响应 周期 中 不 会 发 生 数 据 丢 失 现 象 。 


1.5.4 HTTP 请 求 和 响应 


顾名思义 ,HTTP 请求 是 Web 客户 机 通过 HTTP 发 送 给 服务 器 的 Web 资源 请 求 ;HTTP 
响应 由 服务 器 发 送 ， 并 响应 于 HTTP 事务 中 的 请 求 。 请 求 和 响应 的 关系 如 图 1.28 所 示 。 


HTTP 请 求 
- 


图 1.28 ”请求 和 响应 的 关系 


1.5.5 HTTP 方法 


HTTP 支持 许多 请 求 方法 ， 这 些 方法 也 可 以 称 为 命令 。HTTP 方法 指定 由 服务 器 执行 
的 操作 类 型 。 一 些 常 用 的 HITP 方法 如 表 1.4 所 示 。 
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表 1.4 常用 的 HTTP 方法 


HTTP 方法 H iR 
GET 检索 客户 端 中 已 命名 的 资源 
POST | 在 客户 端 和 服务 器 之 间 传 送 数据 
DELETE 删除 服务 器 端的 某 项 命名 资源 
PUT 将 客户 端 收集 的 数据 存储 在 服务 器 上 的 命名 资源 中 
OPTIONS 返回 服务 器 支持 的 HTTP 方法 
HEAD 


检索 不 包含 任何 内 容 的 HTTP k 


L6 本 章 小 结 


本 章 介 绍 了 Kotlin 语言 及 其 基本 知识 。 在 这 个 过 程 中 ， 我 们 学 习 了 如 何在 计算 机 上 
安装 Kotlin, IDE 的 含义 、 如 何在 IDE 中 编写 Kotlin 程序 、 如 何 编写 和 运行 Kotlin 脚本 ， 
以 及 如 何 使 用 REPL。 此 外 ， 本 章 还 讲解 了 如 何 使 用 IntelliJ IDEA 和 Android Studio， 之 
后 实现 了 一 个 简单 的 Android 应 用 程序 。 最 后 ， 本 章 还 阐述 了 与 网 络 相关 的 基本 概念 。 

在 第 2 章 中 ， 我 们 将 通过 创建 一 个 Android 应 用 程序 ， 以 深入 了 解 Kotlin 程序 。 此 


外 ， 还 将 讨论 Android 应 用 程序 体系 结构 、Android 应 用 程序 的 重要 组 成 部 分 ， 以 及 更 多 
的 主题 。 


第 2 章 构建 Android 应 用 程序 一 一 
俄罗斯 方块 游戏 


在 第 1 章 中 ， 我 们 简要 地 介绍 了 与 核心 Kotlin 语言 相关 的 关键 主题 ， 相 信 读 者 已 经 
了 解 了 Kotlin 的 基本 原理 ， 以 及 强大 的 面向 对 象 编程 方法 ， 并 将 其 用 于 我 们 的 软件 开发 
中 。 在 此 基础 上 ， 本 章 将 开发 一 个 Android 应 用 程序 ， 以 使 我 们 学 到 的 知识 得 以 很 好 地 
应 用 。 

本 章 主要 涉及 以 下 内 容 : 
Android 应 用 程序 组 件 。 
视图 。 
视图 组 。 
利用 XML 实现 布局 。 
字符 串 和 尺寸 。 
处 理 输入 事件 。 

本 章 将 通过 实践 方法 来 学 习 这 些 主 题 , 通过 Android 应 用 程序 这 一 形式 , 实现 一 个 经 
典 游戏 的 布局 和 组 件 ， 即 俄罗斯 方块 游戏 。 在 利用 Android 应 用 程序 开发 游戏 之 前 ,下面 
首先 对 Android 操作 系统 做 一 个 简短 的 概述 。 


Oooooo 


2.1 Android 概述 


Android 是 一 个 基于 Linux 的 移动 操作 系统 ， 由 谷歌 开发 和 维护 ， 主 要 面向 移动 电 
话 和 平板 电脑 等 智能 移动 设备 。 另 外 , 与 Android 操作 系统 交互 的 主要 界面 是 图 形 用 户 界 
ili (GUD Android 设备 用 户 与 操作 系统 环境 之 间 的 操控 和 交互 ， 主 要 是 通过 可 视 化 的 
触摸 界面 加 以 实现 的 ， 例 如 单 击 或 滑动 等 手势 操作 。 

软件 可 通过 App 的 形式 安装 于 Android OS 中 。App 表示 为 一 个 应 用 程序 ， 可 在 某 种 
环境 下 运行 ， 并 执行 一 项 或 多 项 任务 ， 以 实现 特定 的 目标 或 目标 集合 。 在 移动 设备 上 安 
装 应 用 程序 的 能 力 为 用 户 和 应 用 程序 开发 人 员 提 供 了 巨大 的 机 会 。 其 中 ， 用 户 利用 应 用 
程序 提供 的 功能 实现 日 常 目 标 ， 开 发 人 员 根 据 软 件 应 用 程序 的 需求 条 件 ， 开 发 满足 用 户 
需求 的 应 用 程序 ， 并 可 能 获得 利润 。 
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对 于 开发 人 员 来 说 ，Android 为 开发 高 性 能 应 用 程序 提供 了 大 量 的 实用 工具 。 这些 应 
用 程序 可 以 针对 不 同 的 市 场 ， 如 娱乐 、 企 业 和 电子 商务 。 另 外 ， 应 用 程序 也 可 以 游戏 的 
形式 出 现 。 

本 章 将 详细 介绍 Android 应 用 程序 框架 提供 的 一 些 实用 工具 。 

Android 应 用 程序 框架 为 用 户 提供 了 一 些 组 件 ,从 而 可 以 利用 这 些 组 件 为 俄罗斯 方块 
应 用 程序 构建 用 户 界面 。Android 中 的 组 件 是 可 重用 的 程序 模板 或 对 象 ， 可 用 于 定义 应 用 
程序 的 各 项 功能 。Android 应 用 程序 框架 提供 的 一 些 重要 组 件 包括 以 下 几 种 : 
活动 (Activity) 。 
意图 (Intent) 。 
意图 过 滤器 。 
片段 (Fragment) 。 
服务 。 
加 载 器 。 
内 容 提供 商 。 


活动 

活动 代表 了 一 个 Android 组 件 , 它 是 实现 应 用 程序 流 和 组 件 到 组 件 交 互 的 核心 。 活动 
以 类 的 形式 实现 。 一 个 活动 的 实例 被 Android 系统 用 于 代码 初始 化 操作 。 

在 创建 应 用 程序 的 用 户 界面 时 ， 活 动 是 一 个 非常 重要 的 组 件 。 它 提供 了 一 个 窗口 ， 
可 以 绘制 用 户 界面 元 素 。 简 单 地 说 ， 应 用 程序 屏幕 是 在 活动 的 基础 上 创建 的 。 


2.1.2 意图 


DOOOOODO 


N 
- 
gs 


意图 可 促进 活动 间 的 通信 。 TE Android 应 用 程序 中 , 意图 可 以 被 视 为 消息 器 , 用 于 从 
应 用 程序 组 件 请 求 操作 的 消息 对 象 。 意 图 可 针对 动作 加 以 使 用 ， 比 如 请 求 启动 一 个 活动 
并 在 Android 系统 环境 中 传送 广播 。 

相应 地 ， 存 在 以 下 两 种 类 型 的 意图 
QO BRER. 
ü ERAR. 
隐 式 意图 表示 为 一 类 消息 器 对 象 ， 且 并 未 特意 标识 一 个 应 用 程序 组 件 以 执行 某 个 动 
作 ， 而 是 指定 了 一 个 执行 动作 ， 并 人 允许 存在 于 另 一 个 应 用 程序 中 的 组 件 执行 该 动作 。 

显 式 意 图 通过 显 式 方式 指定 应 执行 某 个 动作 的 应 用 程序 组 件 。 这 一 类 意图 可 在 应 用 
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程序 内 执行 相关 动作 ， 例 如 启动 某 项 活动 ， 如 图 2.1 所 示 。 


EN startActivityO [a | onCreate0 ED | 


图 2.1 显 式 意图 


2.1.3 意图 过 滤器 


意图 过 滤器 表示 为 应 用 程序 清单 中 的 一 个 声明 ， 用 于 指定 组 件 接收 的 意图 类 型 。 这 
在 许多 场合 下 均 十 分 有 用 ， 例 如 应 用 程序 中 的 某 项 活动 处 理 另 一 个 应 用 程序 中 的 组 件 所 
请 求 的 特定 动作 。 针 对 处 理 外 部 请 求 的 活动 ， 意 图 过 滤器 可 声明 于 应 用 程序 清单 文件 中 。 
如 果 不 希望 某 项 活动 处 理 隐 式 意图 ， 则 无 须 对 此 声明 意图 过 滤器 。 


2.1.4 片段 


片段 (fragment) 表示 为 一 个 应 用 程序 组 件 ， 体 现 了 活动 中 用 户 界面 的 部 分 内 容 。 与 
活动 类 似 ， 片 段 也 包含 了 可 被 修改 的 布局 ， 并 在 活动 窗口 中 被 绘制 。 


2.1.5 ARS 


与 大 多 数 其 他 组 件 不 同 ， 服 务 并 不 提供 用 户 界面 ， 且 用 于 执行 应 用 程序 中 的 后 台 处 
理 。 另 外 ， 服 务 不 需要 创建 它 的 应 用 程序 在 前 台 运 行 。 


2.1.6 ”加 载 器 


作为 一 种 组 件 ， 加 载 器 可 实现 数据 源 的 数据 加 载 ， 例 如 内 容 提供 商 ， 以 供 后 续 活动 
或 片段 中 的 显示 操作 使 用 。 


24.7 内容 提 供 商 


这 一 类 组 件 有 助 于 控制 数据 资源 的 访问 行为 ， 相 关 资 源 可 能 存储 于 应 用 程序 内 部 或 
外 部 。 除 此 之 外 ， 内 容 提供 商 还 可 通过 公开 的 应 用 程序 编程 接口 促进 与 另 一 个 应 用 程序 
的 数据 共享 ， 如 图 2.2 所 示 。 


。48 。 Kotlin 语言 实例 精 解 


图 2.2 内 容 提 供 商 


22 理解 俄罗斯 方块 游戏 


在 开发 俄罗斯 方块 游戏 之 前 ， 需 要 理解 游戏 的 规则 及 其 约束 条 件 。 
俄罗斯 方块 是 一 类 配对 型 视频 游戏 ， 其 中 使 用 到 了 贴图 块 。 这 里 ， 贴 图 块 由 4 个 相 
互 连 接 的 方块 图 案 组 成 ， 如 图 2.3 所 示 。 


HH aon 


TE 


图 2.3 ”俄罗斯 方块 游戏 中 的 贴图 块 


在 俄罗斯 方块 游戏 中 ， 随 机 图 块 序列 由 屏幕 上 方 下 落 ， 并 通过 玩家 进行 控制 。 其 间 ， 
可 对 每 个 图 块 执行 多 种 运动 操作 ， 包 括 左 移 、 右 移 以 及 旋转 操作 。 另 外 ， 还 可 增加 图 块 
的 下 落 速度 。 游 戏 的 目标 是 通过 下 降 的 图 块 生成 水 平方 向 的 一 行 图 块 。 当 产生 一 行 图 块 
时 ， 整 个 一 行 图 块 将 被 消去 。 

在 理解 了 游戏 规则 后 ， 下 面 首先 讨论 应 用 程序 的 用 户 界面 。 
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23 创建 用 户 界面 


如 前 所 述 ， 用 户 界面 是 指 应 用 程序 用 户 与 App 之 间 的 一 种 交互 方式 。 在 介绍 相关 代 
码 之 前 ， 需 要 先期 勾勒 出 UI 的 图 形 表达 结果 ， 并 可 通过 多 种 工具 予以 实现 ， 例 如 
Photoshop。 目 前 ， 我 们 仅 须 描绘 出 UI 的 大 致 模样 ， 如 图 2.4 所 示 。 


Landing screen Game screen 


TETRIS 


HIGH SCORE: 0 


Tetris 


CURRENT 
SCORE: 


HIGH 
NEW GAME SCORE: 


GAME 


RESET SCORE 


EXIT 


图 2.4 本 示意 图 


在 上 述 示 意图 中 可 以 看 出 ， 当 前 应 用 程序 需要 两 个 不 同 的 区 域 ， 即 配置 区 域 和 体验 
游戏 的 游戏 区 域 ， 且 分 别 需 要 使 用 到 两 个 独立 的 活动 ， 即 MainActivity 和 GameActivity。 

MainActivity 表示 为 应 用 程序 的 入 口 点 , 包含 了 用 户 界面 以 及 与 配置 窗口 相关 的 全 部 
逻辑 。 其 中 ， 配 置 窗口 的 包含 了 应 用 程序 标题 ， 显 示 用 户 积 分 榜 的 视图 ， 以 及 执行 不 
同 动作 的 3 个 按钮 。 这 里 ，NEW GAME 按钮 将 引领 用 户 体验 游戏 ，RESET SCORE 按钮 
将 用 户 的 积分 榜 重 置 为 0，EXIT 按钮 将 关闭 当前 应 用 程序 。 

GameActivity 则 是 游戏 体验 区 域 的 程序 化 模板 。 其 中 ， 将 创建 视图 以 及 用 户 和 游戏 
间 的 逻辑 交互 。 该 活动 的 UI 包含 了 一 个 操作 栏 〈 应 用 程序 的 标题 将 显示 于 其 上 ) ， 两 
个 文本 视图 〈 用 于 显示 用 户 的 当前 分 值 以 及 高 分 积分 榜 ) ， 以 及 游戏 体验 过 程 中 的 布局 
元 素 。 

当前 ， 我 们 已 经 了 解 了 应 用 程序 中 所 需 的 主要 活动 ， 以 及 用 户 界面 的 大 致 状态 。 下 
面 讨论 用 户 界 面 的 实际 实现 。 

在 Android Studio 中 创建 新 的 Android 项 目 ， 并 将 其 命名 为 “Tetris no activity”。 当 
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打开 IDE 窗口 时 ， 将 会 看 到 项 目的 对 应 结构 。 
首先 需要 向 当前 项 目 中 添加 MainActivity, 此 处 MainActivity 应 为 空 活动 。 右 击 资源 数 

据 包 , 在 弹出 的 快捷 菜单 中 选择 New | Activity | Empty Activity 命令 , 即 可 将 MainActivity 

添加 至 项 目 中 ， 如 图 2.5 所 示 。 

re lee) Inman), F1 Ge @khaar 


(© Java Clase 


> m manitosts 
uL Link C++ Project with Gradle 
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| » Ea com.mydomain-tetris | I Copy SC 
> me Copy Path RC 
» E Gradie Scripts Copy as Plain Text 


Copy Reference. xosc 
Gi Paste xv 


Toms aT Snes 


Find Usages NF7 E C/C Source Fle 
Find in Path... ORF Š C/C++ Header Fie 
Roplace in Path... OR 

Analyze pe mace Asmat 


Retactor "| Emgan 


Add to Favorites. > 


Edt File Templates... 
Show Image Thumbnails. ont salt 


Reformat Code xx 
Optimize Imports. axo 
Delete... » Android TV Activity [Requires minsdk >= 21) 

Android Things Empty Activity (Requires minSdk >= 24) 
Basie Activity 

Blank Wear Activity (Requires mi 

Bottom 


D> Run Tests in ‘com mydomain tetris" ^0R 
© Debug 'Tests in ‘com mydomain tetris" “oD 
I Run Tests in 'com.mydomain-tetris" with Coverage 


I Crente Tests in ‘com mydomain tetris... 


Fad ves wd Faas 


Local History > 
O Synchronize tetris! 

Reveal in Finder 
à Compare With... xo 


Mremi lool A 


© Cronte Gist.. 


2.5 将 MainActivity 添加 至 项 目 中 


随后 ， 将 当前 活动 命名 为 MainActivity， 并 确保 选中 Generate Layout File, Launcher 
Activity 以 及 Backwards Compatibility (AppCompat) 复 选 框 。 
一 旦 将 当前 活动 添加 至 项 目 中 ， 即 可 访问 其 布局 资源 文件 ， 如 下 所 示 : 


<?xml version-"1.0" 
encoding-"utf-8"?»«android.support.constraint.ConstraintLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
xmlns:app-"http://schemas.android.com/apk/res-auto" 
xmlns:tools-"http://schemas.android.com/tools" 
android:layout width-"match parent" 
android:layout height-"match parent" 
tools:context="com.mydomain.tetris.MainActivity"> 
</android. support .constraint .ConstraintLayout> 


资源 文件 的 第 一 行 代 码 用 于 指定 文件 版 本 以 及 字符 编码 方案 。 在 该 文件 中 ， 采 用 了 
utf-8 字符 编码 方案 。 此 处 ，UTF 是 指 Unicode 转换 格式 。 作 为 一 种 编码 格式 ，UTTF 与 美 
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国信 息 交换 标准 码 CASI 码 ) 具有 相同 的 紧凑 格式 ， 且 包含 了 任意 的 Unicode 字符 ， 而 
后 者 是 文本 文件 中 常用 的 字符 格式 。 随 后 的 8 行 代 码 定义 了 MainActivity UI 中 所 显示 的 
ConstraintLayout. 


在 进一步 讨论 之 前 ， 下 面 首 先 详 细 考 察 ConstraintLayout。 


2.3.4 ConstraintLayout 


ConstraintLayout 表示 为 视图 组 的 类 型 ， 并 支持 灵活 的 定位 以 及 应 用 程序 微 件 的 尺寸 
重 置 。 相 应 地 ， 各 种 约束 类 型 均 可 应 用 于 ConstraintLayout 上 。 


1. 边 距 

边 距 是 指 两 个 布局 元 素 之 间 的 空白 区 域 。 当 在 某 个 元 素 上 设置 侧 边 距 时 ， 则 适用 于 
对 应 的 布局 约束 条 件 。 也 就 是 说 ， 在 目标 端 和 源 端 〈 添 加 了 边 距 的 元 素 一 侧 ) 之 间作 为 
空白 区 域 添加 边 距 ， 如 图 2.6 所 示 。 


边 距 


图 2.6 边 距 
2. 链 


链表 示 为 约束 条 件 ， 并 在 单一 轴 向 上 提供 了 分 组 行为 。 相 应 地 ， 对 应 轴 向 可 以 是 水 
平 轴 或 垂直 轴 ， 如 图 2.7 所 示 。 


as m oL 


< 
链 


图 2.7 链 
如 果 元 素 集合 均 为 双向 连接 ， 那 么 ， 该 集合 称 作 链 。 
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3. 尺寸 约束 


此 类 约束 条 件 关 系 到 置 于 某 个 布局 中 的 微 件 尺寸 。 尺 寸 约束 可 在 微 件 上 进行 设置 ， 
同时 使 用 到 ConstraintLayout， 如 图 2.8 所 示 。 


图 2.8 尺寸 约束 


这 里 ， 微 件 的 尺寸 可 通过 android:layout width 和 android:layout height 加 以 确定 ， 如 
下 所 示 : 


<TextView 
android:layout height="16dp" 
android:layout width-"32dp"/» 


大 多 数 时 候 ， 可 能 需要 某 个 微 件 与 其 父 视图 分 组 具有 相同 的 尺寸 ， 对 此 ， 可 将 
match parent 值 赋予 尺寸 属性 中 ， 如 下 所 示 : 


<LinearLayout 
android:layout width-"120dp" 
android:layout height-"100dp"» 
<TextView 
android:layout width="match parent" 
android:layout height-"match parent"/» 
</LinearLayout> 


另外 ， 如 果 和 希望 微 件 的 尺寸 不 固定 ， 同 时 封装 其 中 的 元 素 ， 那 么 ， 应 将 wrap content 
值 赋予 尺寸 属性 中 ， 如 下 所 示 : 


<TextView 

android:layout width="wrap content" 

android:layout height-"wrap content" 
android:text-"I wrap around the content within me" 
android:textSize-"15sp"/» 


上 述 内 容 详 细 讨论 了 ConstraintLayout， 以 及 微 件 约束 条 件 。 下 面 查看 activity - 
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main.xml 文件 ， 如 下 所 示 : 


Xandroid.support.constraint.ConstraintLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
xmlns:app-"http://schemas.android.com/apk/res-auto" 
xmlns:tools-"http://schemas.android.com/tools" 
android:layout width-"match parent" 
android:layout height-"match parent" 
tools:context="com.mydomain.tetris.MainActivity"> 
</android.support.constraint.ConstraintLayout> 


对 于 ConstraintLayout 元 素 ， 不 难 发 现 ， 其 宽度 和 高 度 尺寸 被 设置 为 match parent. 
这 意味 着 ，ConstraintLayout 尺寸 被 设置 为 与 当前 窗口 中 的 尺寸 相 匹 配 。 包含 xmlns: prefix 
的 属性 用 于 定义 XML 命名 空间 。 相 应 地 ， 针 对 所 有 XML 命名 空间 属性 设置 的 值 表 示 为 
命名 空间 URI。 这 里 ，URI 是 统一 资源 标识 符 的 缩写 。 顾 名 思 义 ，URI 用 于 标识 命名 空 
间 所 需 的 资源 。 

tools:context 通常 被 设置 为 XML 布局 文件 中 的 根 元 素 ， 并 指定 布局 所 关联 的 活动 ， 
当前 为 MainActivity。 

前 述 内 容 探 讨 了 activity main.xml 布局 ,下 面向 其 中 添加 某 些 布局 元 素 。 在 前 述 游戏 
界面 示意 图 中 ， 全 部 布局 元 素 均 以 垂直 排列 方式 设置 。 对 此 ， 可 使 用 LinearLayout， 如 下 
所 示 : 

<android.support.constraint.ConstraintLayout 

xmlns:android="http://schemas.android.com/apk/res/android" 


xmlns:app-"http://schemas.android.com/apk/res-auto" 
xmlns:tools-"http://schemas.android.com/tools" 


android:layout width-"match parent" 
android:layout height-"match parent" 
tools:context="com.mydomain.tetris.MainActivity"> 
<LinearLayout 
android:layout width="match parent" 
android:layout height-"match parent" 
app:layout constraintBottom toBottomOf-"parent" 
app:layout constraintLeft toLeftOf-"parent" 
app:layout constraintRight toRightOf-"parent" 
app:layout constraintTop toTopOf-"parent" 
android:layout marginVertical-"16dp" 
android:orientation-"vertical"» 
</LinearLayout> 
</android.support.constraint.ConstraintLayout> 
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考虑 到 LinearLayout 应 与 其 父 元 素 包含 相同 的 尺寸 ， 


因而 可 将 android:layout_width 


和 android:layout height 设置 为 match_parent。 随 后 ， 可 使 用 app:layout constraintBottom - 
toBottomOf app:layout constraintLeft toLeftOf, app:layout constraintRight toRightOf 以 
及 app:layout constraintTop toTopOf 属性 确定 LinearLayout 的 边界 约束 条 件 。 


口 ”app:layout_constraintBottom toBottomOf: 将 元 素 的 底 边 对 齐 到 另 一 个 元 素 的 底部 。 
口 app:layout_constraintLeft toLeftOf: 将 元 素 的 左边 对 齐 到 另 一 
口 app:layout_constraintRight toRightOf: 将 元 素 的 右边 对 齐 到 另 一 
mū app:layout constraintTop toTopOf: 将 元 素 的 上 方 对 齐 到 另 一 
此 时 ，LinearLayout 的 各 边 均 与 父 元 素 的 边缘 对 齐 一 一 ConstraintLayout. android: 


个 元 素 的 左 侧 。 
个 元 素 的 右 侧 。 
个 元 素 的 上 方 。 


layout_marginVertical 将 16dp 的 边 距 添加 至 当前 元 素 的 上 方 和 下 方 。 


2.3.2 ”定义 尺寸 资源 


通常 情况 下 ， 在 一 
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图 2.9 创建 新 值 资源 文件 


个 布局 文件 中 ， 可 包含 多 个 元 素 ， 并 向 属性 指定 同 
这 一 类 值 应 添加 至 某 个 尺寸 资源 文件 中 。 下 面 将 对 此 创建 一 个 尺寸 源 文件 。 在 应 用 程序 
项 目 视 图 中 ， 访 问 res | values， 并 在 dimens 目录 中 创建 新 值 资源 文件 ， 如 图 2.9 所 示 。 
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其 他 文件 属性 则 保留 默认 状态 ， 如 图 2.10 所 示 。 
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图 2.10 其 他 文件 属性 保留 默认 状态 
待 创建 完毕 后 ， 打 开 对 应 文件 ， 相 关内 容 如 下 所 示 : 


<?xml version-"1.0" encoding="utf-8"?> 
<resources></resources> 


dimens.xml 文件 中 的 第 一 行 代码 表示 当前 文件 中 所 使 用 的 XML 版 本 , 以 及 字符 编码 
方案 。 第 二 行 代码 包含 了 一 个 <resources> 资 源 标签 ， 当 前 尺寸 将 在 该 标签 内 声明 。 随 后 
可 添加 一 些 尺寸 值 ， 如 下 所 示 : 


<?xml version-"1.0" encoding-"utf-8"?» 

«resources» 
Xdimen name-"layout margin top"»16dp«/dimen» 
<dimen name-"layout margin bottom"»16dp«/dimen» 
<dimen name-"layout margin start"»16dp«/dimen» 
<dimen name-"layout margin end">16dp</dimen> 
<dimen name-"layout margin vertical">16dp</dimen> 

</resources> 
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新 尺寸 通过 <dimen> 标 签 加 以 声明 。 一 般 情 况 下 , 尺寸 名 称 应 采用 Snake Case 方式 书 
写 。 另 外 ， 尺 寸 值 应 添加 至 <dimen> 和 </dimen> 标 签 之 间 。 
待 尺寸 添加 完毕 后 ， 即 可 在 LinearLayout 中 对 其 加 以 使 用 ， 如 下 所 示 : 


Xandroid.support.constraint.ConstraintLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
xmlns:app-"http://schemas.android.com/apk/res-auto" 
xmlns:tools-"http://schemas.android.com/tools" 
android:layout width-"match parent" 
android:layout height-"match parent" 
tools:context-"com.mydomain.tetris.MainActivity"» 
<LinearLayout 
android:layout width="match parent" 
android:layout height="match parent" 
app: layout constraintBottom toBottomOf-"parent" 
app:layout constraintLeft toLeftOf-"parent" 
app:layout constraintRight toRightOf-"parent" 
app:layout constraintTop toTopOf-"parent" 
android:layout marginTop-"Gdimen/layout margin top" 
<!— layout margin top dimension reference 一 > 
android:layout marginBottom="@dimen/layout margin bottom" 
<!— layout margin top dimension reference 一 > 
android:orientation-"vertical" 
android:gravity-"center horizontal"» 
</LinearLayout> 
</android.support.constraint.ConstraintLayout> 


我 们 已 经 设置 了 LinearLayout 视图 组 ， 现 在 需要 向 它 添加 所 需 的 布局 视图 。 在 此 之 
前 ， 首 先 需要 理解 视图 以 及 视图 组 这 两 个 概念 。 


2.8.3 ”视图 


视图 表示 为 一 种 布局 元 素 ， 占 据 屏幕 的 一 个 设 定 区 域 ， 并 负责 绘制 和 事件 处 理 。 视 图 
是 UI 元 素 和 微 件 〈 例 如 文本 框 、 输 入 框 和 按钮 ) 的 基 类 ， 所 有 的 视图 均 扩展 了 View 类 。 
视图 可 在 某 个 资源 文件 的 XML 布局 中 创建 。 考 察 下 列 代码 : 


<TextView 

android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"Roll the dice!"/> 
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除了 直接 在 布局 文件 中 生成 视图 ， 还 可 在 程序 文件 中 以 编程 方式 实现 。 例 如 ， 可 创 
建 一 个 TextView 类 实例 ， 并 向 其 构造 方法 中 传递 context， 进 而 生成 文本 视图 。 对 应 代码 
片段 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 
override fun onCreate(savedInstanceState: Bundle?) ( 
super.onCreate (savedInstanceState) 
setContentView(R.layout.activity main) 
val textView: TextView = TextView(this) 
} 
} 


2.3.4 视图 组 


视图 组 则 是 一 种 较为 特殊 的 视图 类 型 ， 其 中 包含 了 多 个 视图 。 包 含 一 个 或 多 个 视图 
的 视图 组 一 般 称 作 父 视图 ; 而 所 包含 的 视图 则 称 作 子 视图 。 视 图 组 表示 为 多 个 其 他 视图 
容器 的 父 类 。 视 图 组 的 例子 包括 LinearLayout、CoordinatorLayout、ConstriantLayout、 
RelativeLayout、AbsoluteLayout、GridLayout 以 及 FrameLayout。 

视图 组 可 在 源 文件 的 XML 布局 中 创建 ， 如 下 所 示 : 

<LinearLayout 

android:layout width-"wrap content" 

android:layout height-"wrap content" 


android:layout marginTop-"16dp" 
android:layout marginBottom-"16dp"/» 


类 似 于 视图 ， 视 图 组 也 可 在 组 件 类 中 以 编程 方式 创建 。 下 列 代码 片段 创建 了 一 个 
LinearLayout 类 实例 ， 并 将 MainActivity 的 context 传递 至 其 构造 方法 中 ， 进 而 设置 线性 
布局 。 


class MainActivity : AppCompatActivity() ( 
override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate (savedInstanceState) 
setContentView(R.layout.activity main) 
val linearLayout: LinearLayout - LinearLayout (this) 
) 
} 


在 理解 了 视图 和 视图 组 这 两 个 概念 后 ， 可 向 当前 布局 中 添加 多 个 视图 。 相 应 地 ， 可 
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利用 <TextView> 元 素 向 布局 中 添加 文本 视图 ， 并 通过 <Button> 元 素 添 加 按钮 ， 如 下 所 示 : 


«?xml version-"1.0" encoding-"utf-8"?» 
<android. support .constraint.ConstraintLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
xmlns:app-"http://schemas.android.com/apk/res-auto" 
xmlns:tools-"http://schemas.android.com/tools" 
android:layout width-"match parent" 
android:layout height-"match parent" 
tools:context="com.mydomain.tetris.MainActivity"> 
<LinearLayout 
android:layout width="match parent" 
android:layout height-"match parent" 
app:layout constraintBottom toBottomOf-"parent" 
app:layout constraintLeft toLeftOf-"parent" 
app:layout constraintRight toRightOf-"parent" 
app:layout constraintTop toTopOf-"parent" 
android: layout_marginTop="@dimen/layout_margin_ top" 
android:layout marginBottom="@dimen/layout margin bottom" 
android: orientation="vertical"> 
<TextView 
android: layout_width="wrap_ content" 
android:layout height-"wrap content" 
android:text-"TETRIS" 
android:textSize-"80sp"/» 
<TextView 
android:id="@+id/tv high score" 
android:layout width="wrap content" 
android:layout height-"wrap content" 
android:text-"High score: 0" 
android:textSize-"20sp" 
android:layout marginTop="@dimen/layout margin top"/> 
<LinearLayout 
android:layout width-"match parent" 
android: layout_height="0dp" 
android:layout weight="1" 
android:orientation="vertical"> 
<Button 


android:id="@tid/btn new game" 
android:layout width="wrap content" 
android: layout_height="wrap_ content" 


第 2 章 构建 Android 应 用 程序 一 一 俄罗斯 方块 游戏 *59* 


android:text-"New game"/» 

«Button 
android:id-"(*id/btn reset score" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"Reset score"/> 

«Button 
android:id="@+id/btn exit" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"exit"/» 

</LinearLayout> 
</LinearLayout> 
«/android.support.constraint.ConstraintLayout» 


在 游戏 界面 示意 图 中 , 已 经 添加 了 两 个 文本 视图 以 加 载 应 用 程序 标题 、 积 分 榜 以 及 3 
个 按钮 ， 进 而 可 执行 所 需 动 作 。 此 处 使 用 了 两 个 新 属性 ， 即 android:id 和 android:layout_ 
weight。 其 中 ，android:id 用 于 设置 布局 元 素 的 唯一 标识 符 。 在 同一 个 布局 中 ， 不 可 存在 
两 个 相同 的 ID。 对 于 视图 在 其 父 容 器 中 应 该 占用 多 少 空间 ，android:layout_weight 属性 用 
于 设置 优先 值 ， 如 下 所 示 : 


<LinearLayout 
android:layout width="match parent" 
android:layout height="match parent" 
android:orientation="vertical"> 
<Button 
android:layout width-"70dp" 
android:layout height-"40dp" 
android:text-"Click me"/» 
«View 
android:layout width-"70dp" 
android: layout_height="0dp" 
android: layout_weight="1"/> 
</LinearLayout> 


在 上 述 代 码 片段 中 , 线性 布局 中 包含 了 两 个 子 视图 。 其中, 按钮 的 尺寸 约束 分 别 为 70dp 
和 40dp。 男 外 一 方面 ， 视 图 的 宽度 显 式 地 设置 为 70dp， 其 高 度 设置 为 0dp。 在 android: 
layout weight 属性 设置 为 1 后 ， 视 图 的 高 度 被 设置 为 覆盖 父 视 图 中 的 所 有 剩余 空间 。 

图 2.11 显示 了 当前 布局 设计 的 预览 图 。 
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TETRIS 


High score: 0 


NEW GAME 


RESET SCORE 


EXIT 


图 2.11 当前 布局 设计 的 预览 图 


与 之 前 的 示意 图 相 比 ， 图 2.11 中 的 某 些 元 素 似乎 消失 了 。 另 外 ， 当 前 布局 内 容 实现 
了 右 对 齐 ， 而 非 前 述 居 中 排列 。 对 此 ， 可 在 线性 布局 视图 组 中 使 用 android:gravity 属性 。 
在 下 列 代码 片段 中 ,通过 android:gravity 属性 ,在 两 个 线性 布局 中 均 实现 了 布局 微 件 的 居 
中 设置 。 


<?xml version-"1.0" encoding="utf-8"?> 
<android.support.constraint.ConstraintLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
xmlns:app-"http://schemas.android.com/apk/res-auto" 
xmlns:tools-"http://schemas.android.com/tools" 
android:layout width-"match parent" 
android:layout height-"match parent" 
tools:context-"com.mydomain.tetris.MainActivity"^ 
<LinearLayout 
android: layout width="match parent" 
android:layout height-"match parent" 
app:layout constraintBottom toBottomOf-"parent" 
app:layout constraintLeft toLeftOf-"parent" 
app:layout constraintRight toRightOf-"parent" 
app:layout constraintTop toTopOf-"parent" 
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android:layout marginTop="@dimen/layout margin top" 
android:layout marginBottom="@dimen/layout margin bottom" 
android:orientation-"vertical" 
android:gravity-"center"» 
<!-- Aligns child elements to the centre of view group --> 
<TextView 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"TETRIS" 
android:textSize-"80sp"/» 
<TextView 
android: id="@+id/tv_high score" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text="High score: 0" 
android: textSize="20sp" 
android: layout_marginTop="@dimen/layout_margin_top"/> 
<LinearLayout 
android:layout width="match parent" 
android:layout height="0dp" 
android:layout weight="1" 
android: orientation="vertical" 
android: gravity="center"> 
<!-- Aligns child elements to the centre of view group --> 
<Button 
android:id="@+id/btn new game" 
android:layout width="wrap content" 
android:layout height-"wrap content" 
android:text-"New game"/» 
«Button 
android: id="@tid/btn reset score" 
android:layout width="wrap content" 
android:layout height-"wrap content" 
android:text-"Reset score"/» 
«Button 
android: id="@+id/btn_exit" 
android:layout width="wrap content" 
android:layout height-"wrap content" 
android:text-"exit"/» 
</LinearLayout> 
</LinearLayout> 
</android.support.constraint.ConstraintLayout> 
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其 中 ，android:gravity 设置 为 center， 微 件 最 终 以 期 望 的 方式 排列 。 图 2.12 显示 了 当 
前 布局 视图 组 中 添加 了 android:gravity 视图 组 后 的 效果 。 


Tetris 


TETRIS 


High score: 0 


图 2.12 添加 了 android:gravity 视图 组 后 的 效果 
2.8.55 ”定义 字符 串 资 源 


前 述 内 容 讨论 了 如 何 将 硬 编码 字符 串 作 为 数值 传递 至 元 素 属性 中 (需要 设置 文本 ) 。 
总 体 来 说 ， 这 并 非 是 最 佳 方法 且 一 般 应 尽量 避免 。 相 应 地 ， 字 符 串 值 应 添加 至 字符 串 资 
源 文 件 中 。 

strings.xml 是 字符 串 资源 的 默认 文件 ， 且 位 于 res | values 目录 中 ， 如 图 2.13 所 示 。 

通过 <string> XML 标签 ， 字 符 串 值 可 作为 字符 串 资 源 予以 添加 。 针 对 目前 所 用 的 所 
有 字符 串 值 ， 需 要 添加 字符 串 资源 。 对 此 ， 可 向 字符 串 资源 文件 中 加 入 下 列 代码 。 


«resources» 


«string name="app_name">Tetris</string> 

<string name-"high score default">High score: 0</string> 
Xstring name-"new game">New game</string> 

«string name-"reset score"»Reset score</string> 


第 2 章 构建 Android 应 用 程序 一 一 俄罗斯 方块 游戏 *63* 


<string name="exit">exit</string> 


</resources> 
= Tetris) Bgapp) B src) Ba main) ves) Di vales) Gb eros emi Ato Pleo amasb 
& Adroa - O+ o r om |B Gimensaanl X | S Maine a 
pes = ; 
^ manifests EH 
» gaa = «string nane="app_nase">Tetris</string> 
res </resources> 
5 drawable 
i > layout 
5 mipmap 
? values 
ii colors xm! 
i f eimens xm 
8 二 Strings.xmi 
M A styles.xmi 
- * (© Gradle Scripts 
" 
t 3 
: i 
E i 
P7000 logcnt A Android Profiler Terminal A Event Log B Oracle Consdle 
E] Pto and Pin Updates: Restart Android Studio to activate changes in plugins? today 9.35 P) suae » 8 


图 2.13 字符 串 资源 的 默认 文件 


另外 ， 有 必要 编辑 MainActivity 布局 文件 ， 进 而 使 用 所 创建 的 资源 。 字 符 串 资源 可 
以 用 @strings/ 前 缀 字符 串 资 源 名 来 引用 ， 如 下 所 示 : 


<?xml version-"1.0" encoding-"utf-8"?» 
<android.support.constraint.ConstraintLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
xmlns:app-"http://schemas.android.com/apk/res-auto" 
xmlns:tools-"http://schemas.android.com/tools" 
android:layout width-"match parent" 
android:layout height-"match parent" 
tools:context-"com.mydomain.tetris.MainActivity"» 


<LinearLayout 
android:layout width="match parent" 
android:layout height="match parent" 
app:layout constraintBottom toBottomOf-"parent" 
app:layout constraintLeft toLeftOf-"parent" 
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app:layout constraintRight toRightOf-"parent" 
app:layout constraintTop toTopOf-"parent" 
android:layout marginTop-"Gdimen/layout margin top" 
android: layout_marginBottom="@dimen/layout_margin bottom" 
android:orientation="vertical" 
android: gravity="center"> 
<!-- Aligns child elements to the centre of view group --> 
<TextView 
android:layout width="wrap content" 
android:layout height-"wrap content" 
android:text-"Gstring/app name" 
android:textAllCaps-"true" 
android:textSize-"80sp"/» 
<TextView 
android:id="@+id/tv_high score" 
android:layout width="wrap content" 
android:layout height-"wrap content" 
android:text-"estring/high score default" 
android:textSize-"20sp" 
android:layout marginTop="@dimen/layout margin top"/> 
<LinearLayout 
android:layout width-"match parent" 
android:layout height="0dp" 
android:layout weight="1" 
android:orientation-"vertical" 
android:gravity="center"> 
<!-- Aligns child elements to the centre of view group --> 
<Button 
android: id="@+id/btn_new_game" 
android:layout width-"wrap content" 


android:layout height-"wrap content" 
android:text="@string/new game"/> 
<Button 
android: id="@+id/btn reset score" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text="@string/reset score"/> 
<Button 
android: id="@+id/btn_exit" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android: text="@string/exit"/> 
</LinearLayout> 
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</LinearLayout> 
</android.support.constraint .ConstraintLayout> 


2.3.6 ”处 理 输入 事件 


在 用 户 与 应 用 程序 交互 的 循环 过 程 中 ， 通 过 与 微 件 之 间 的 交互 ， 用 户 可 以 为 流程 的 


执行 提供 某 种 形式 的 输入 ,这 一 类 输入 可 通过 事件 予以 捕捉 。 在 Android 应 用 程序 中 , 3 
件 可 从 用 户 所 交互 的 、 特 定 的 视图 对 象 中 被 捕捉 。 对 于 输入 事件 处 理 ，View 类 提供 了 所 
需 的 结构 和 处 理 过 程 。 


H 


事件 监听 器 是 应 用 程序 中 的 一 个 处 理 程序 ， 并 等 待 UI 事件 的 出 现 。 应 用 程序 中 可 设 


置 多 种 类 型 的 事件 ， 一 些 较为 常见 的 事件 包括 单 击 事件 、 触 摸 事件 、 长 时 间 按 键 事件 以 
及 文本 变化 事件 。 


为 了 捕捉 微 件 事件 并 执行 某 个 动作 ， 事 件 监听 器 需要 在 视图 中 被 设置 ， 这 可 以 通过 


调用 一 个 视图 的 set. Listener( 方 法 来 实现 ， 并 向 方法 中 传递 一 个 lambda 或 指向 某 个 函数 
的 引用 。 


下 列 示例 展示 了 按钮 上 的 单 击 事件 的 捕捉 操作 。 其 中 ，Lambda 传递 至 视图 类 的 


setOnClickListener 方法 中 。 


val button: Button = findViewById«Button» (R.id.btn send) 
button.setOnClickListener { 
// actions to perform on click event 


} 
相应 地 ， 也 可 采用 指向 函数 的 引用 替代 lambda, St Fra: 


class MainActivity : AppCompatActivity() ( 
override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate (savedInstanceState) 
setContentView(R.layout.activity main) 
val btnExit: Button = findViewById«Button» (R.id.btn exit) 
btnExit.setOnClickListener (this::handleExitEvent) 
) 
fun handleExitEvent(view: View) ( 
finish() 
) 
) 


视图 类 中 定义 了 大 量 的 监听 器 setter 方法 ， 如 下 所 示 。 
DP setOnClickListener): 设置 一 个 函数 ， 并 在 视图 单 击 操作 中 被 调用 。 
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口 


setOnContextClickListener0: 设置 一 个 函数 ,并 在 视图 的 上 下 文 单 击 操作 中 被 调用 。 
setOnCreateContextMenuListener(): 设置 一 个 函数 ， 并 在 创建 视图 快捷 菜单 时 被 
调用 。 
setOnDragListener(): 设置 一 个 函数 ， 并 在 视图 中 出 现 拖 忠 事 件 时 被 调用 。 
setOnFocusChangeListener(): 设置 一 个 函数 ， 并 在 视图 焦点 变化 时 被 调用 。 
setOnHoverChangeListener(): 设置 一 个 函数 ,并 在 视图 上 出 现 悬 停 事件 时 被 调用 。 
setOnLongClickListener(): 设置 一 个 函数 ， 并 在 视图 上 出 现 长 按 操作 时 被 调用 。 
setOnScrollChangelistener(): 设置 一 个 函数 ， 并 在 视图 的 滚动 位 置 XRY) 发 
生变 化 时 被 调用 。 
O xs. 

事件 监听 器 是 应 用 程序 中 的 一 个 处 理 程序 ， 并 等 待 UI 事件 的 出 现 

在 理解 了 如 何 处 理 出 入 事件 后 ， 下 面 讨 论 MainActivity 逻辑 实现 。 

当前 主要 的 活动 界面 是 App 操作 栏 ， 鉴 于 当前 视图 并 不 需要 使 用 到 这 一 元 素 ， 因 而 
可 暂且 将 其 隐藏 ， 如 图 2.14 所 示 。 


D 


Ooocoo 


图 2.14 App 操作 栏 


App 操作 栏 也 称 作 动 作 栏 ， 且 定义 为 ActionBar 类 的 实例 。 布局 中 的 动作 栏 微 件 实 例 
可 通过 supportActionBar 访问 器 变量 获得 。 下 列 代码 将 得 到 一 个 动作 栏 ， 如果 未 返回 空 引 
用 ， 则 对 其 加 以 隐藏 。 


package com.mydomain.tetris 

import android.support.v7.app.AppCompatActivity 
import android.os.Bundle 

import android.support.v7.app.ActionBar 

import android.view.View 

import android.widget.Button 


class MainActivity : AppCompatActivity() { 
override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate (savedInstanceState) 
setContentView(R.layout.activity main) 
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val appBar: ActionBar? = supportActionBar 


if (appBar !- null) ( 
appBar.hide() 
) 
} 
} 


虽然 上 述 代码 实现 了 所 需 任务 ， 但 通过 Kotlin 的 类 型 安全 系统 ， 代 码 量 还 可 大 幅 降 
低 ， 如 下 所 示 : 


package com.mydomain.tetris 

import android.support.v7.app.AppCompatActivity 
import android.os.Bundle 

import android.view.View 

import android.widget.Button 


class MainActivity : AppCompatActivity() ( 
override fun onCreate(savedInstanceState: Bundle?) ( 
super.onCreate (savedInstanceState) 
setContentView(R.layout.activity main) 
supportActionBar?.hide() 
) 
) 


如 果 supportActionBar 并 非 是 空 对象 引 用 ， 同 时 未 执行 其 他 操作 ， 则 可 调用 hide0 方 
法 ， 这 可 有 效 地 防止 出 现 空 指针 异常 。 

对 于 当前 布局 中 的 微 件 ， 需 要 创建 对 应 的 对 象 引 用 。 这 对 于 许多 场合 均 十 分 有 用 ， 
例如 监听 器 注册 。 视 图 的 对 象 引 用 可 通过 下 列 方式 得 到 : 将 视图 的 资源 ID 传递 至 
findViewById0 中 。 下 列 代码 片段 将 对 象 引用 传递 至 MainActivity (位 于 MainActivity.kt 
文件 内 ) 中 。 

package com.mydomain.tetris 

import android.support.v7.app.AppCompatActivity 

import android.os.Bundle 

import android.view.View 


import android.widget.Button 
import android.widget.TextView 


class MainActivity : AppCompatActivity() { 


var tvHighScore: TextView? = null 


* 68 。 Kotlin 语言 实例 精 解 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate (savedInstanceState) 
setContentView(R.layout.activity main) 
supportActionBar?.hide() 


val btnNewGame = findViewById«Button» (R.id.btn new game) 

val btnResetScore = findViewById«Button» (R.id.btn reset score) 
val btnExit - findViewById«Button» (R.id.btn exit) 

tvHighScore = findViewById<TextView>(R.id.tv high score) 


} 


当前 ， 用 户 界 面 元 素 的 对 象 引用 已 设置 完毕 ， 下 面 需要 处 理 其 中 的 事件 。 对 于 布局 
内 的 所 有 按钮 ， 需 要 定义 单 击 监听 器 〈 毕 竟 ， 单 击 按钮 后 需要 执行 相关 操作 ) 。 

如 前 所 述 ，New Game 按钮 的 唯一 功能 是 令 用 户 进入 游戏 中 〈 即 体验 游戏 ) 。 对 此 ， 需 
要 使 用 到 显 式 意图 。 相 应 地 ， 可 向 MainActivity (位 于 MainActivity.kt 文件 中 ) 添加 一 个 私 
有 函数 , 其 中 包含 了 New Game 按钮 单 击 操作 所 包含 的 执行 逻辑 , 并 通过 setOnClickListener() 
调用 设置 指向 该 函数 的 引用 ， 如 下 所 示 : 


package com.mydomain.tetris 


import android.support.v7.app.AppCompatActivity 
import android.os.Bundle 

import android.view.View 

import android.widget.Button 

import android.widget.TextView 


class MainActivity : AppCompatActivity() ( 
var tvHighScore: TextView? = null 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate (savedInstanceState) 
setContentView(R.layout.activity main) 
supportActionBar?.hide() 
val btnNewGame findViewById«Button» (R.id.btn new game) 
val btnResetScore = findViewById«Button» (R.id.btn reset score) 
val btnExit = findViewById«Button» (R.id.btn exit) 
tvHighScore = findViewById«TextView» (R.id.tv high score) 
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btnNewGame.setOnClickListener (this: :onBtnNewGameClick) 


} 


private fun onBtnNewGameClick(view: View) { } 


} 


随后 ， 可 创建 新 的 空 活动 ， 并 将 其 命名 为 GameActivity。 在 该 活动 构建 完毕 后 ， 可 
利用 相关 意图 启动 New Game 按钮 单 击 操作 上 的 活动 ， 如 下 所 示 : 
private fun onBtnNewGameClick (view: View) { 


val intent = Intent(this, GameActivity::class.java) 
startActivity (intent) 


} 


函数 中 的 第 一 行 代 码 将 生成 ntent 类 的 新 实例 , 并 将 当前 上 下 文 和 所 需 的 活动 类 传递 
至 构造 方法 中 。 注 意 ， 此 处 传递 了 this 作为 构造 方法 中 的 第 一 个 参数 。 其 中 ， 调 用 this 


关键 字 将 引用 当前 实例 。 因 


此 ， 实 际 上 将 当前 活动 (MainActivity) 作为 第 一 个 参数 传递 


至 构造 方法 中 。 这 里 ， 读 者 可 能 会 稍 感 疑 惑 ， 当 需要 上 下 文 作为 第 一 个 参数 时 ， 为 何 传 
递 一 个 活动 , 并 作为 Intent 构造 方法 中 的 第 一 个 参数 ? 其 原因 在 于 : 所 有 活动 均 为 Context 
抽象 类 的 扩展 。 因 此 ， 全 部 活动 均 处 于 自身 正确 的 上 下 文 环境 中 。 

startActivity0 方 法 被 调用 来 启动 一 个 没有 预期 结果 的 活动 。 当 某 个 意图 作为 其 唯一 参 
数 被 传递 时 ， 将 启动 一 个 无 预期 结果 的 活动 。 读 者 可 尝试 运行 该 应 用 程序 ， 并 查看 单 击 


按钮 后 的 效果 。 
O sz. 


Context 表示 为 Android 应 用 程序 框架 中 的 一 个 抽象 类 , 某 个 上 下 文 的 实现 由 Android 
系统 提供 。Context 允许 访问 特定 的 应 用 程序 资源 ,访问 并 调用 应 用 程序 级 别 的 操作 ， 例 
如 启动 某 项 活动 、 发 送 广播 以 及 接收 意图 。 

下 面 实现 EXIT 和 RESET SCORE 按钮 的 单 击 操作 ， 如 下 所 示 : 


package com.mydomain.tetris 


import android.content.Intent 


import android.support.v7.app.AppCompatActivity 


import android.os.Bundle 


import android.view 


.View 


import android.widget.Button 


import android.widget.TextView 


class MainActivity : 


AppCompatActivity() { 


。70 。 Kotlin 语言 实例 精 解 


var tvHighScore: TextView? = null 


override fun onCreate(savedInstanceState: Bundle?) ( 
super.onCreate (savedInstanceState) 
setContentView(R.layout.activity main) 
supportActionBar?.hide() 


val btnNewGame = findViewById«Button» (R.id.btn new game) 
val btnResetScore = findViewById«Button» (R.id.btn reset score) 
val btnExit - findViewById«Button» (R.id.btn exit) 
tvHighScore = findViewById<TextView>(R.id.tv high score) 
btnNewGame.setOnClickListener(this::onBtnNewGameClick) 
btnResetScore.setOnClickListener(this::onBtnResetScoreClick) 
btnExit.setOnClickListener(this::onBtnExitClick) 

) 


private fun onBtnNewGameClick(view: View) ( 
val intent - Intent(this, GameActivity::class.java) 
startActivity (intent) 

) 


private fun onBtnResetScoreClick(view: View) {} 


private fun onBtnExitClick(view: View) { 
System.exit (0) 
) 

) 

当 整 数 0 作为 参数 被 传递 时 ，onBtnExitClick 函数 中 的 System.exitO 被 调用 ， 将 终止 
程序 的 进一步 执行 并 退出 。 最 后 一 项 需要 完成 的 任务 是 处 理 单 击 事件 ， 进 而 实现 重 置 积 
分 榜 时 的 操作 逻辑 。 对 此 ， 首 先 需要 实现 某 些 数据 存储 逻辑 ， 以 存储 高 分 值 。 此 处 将 使 
用 到 SharedPreferences。 


2.3.7 5 SharedPreferences 协同 工作 


SharedPreferences 定义 为 一 个 接口 ， 用 于 存储 、 访 问 和 修改 数据 。SharedPreferences 
API 支持 键 - 值 对 集合 的 数据 存储 操作 。 

下 面 将 利用 SharedPreferences 接口 并 针对 当前 App 处 理 数 据 存储 问题 。 首 先 ， 可 在 
项 目的 源 目录 storage 中 创建 一 个 数据 包 〈 右 击 源 目录 ， 在 弹出 的 快捷 菜单 中 选择 New | 
Package 命令 ) ， 如 图 2.15 所 示 。 
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图 2.15 创建 一 个 数据 包 


接 下 来 ， 在 storage 数据 包 中 定义 一 个 新 的 Kotlin 类 AppPreferences， 并 向 该 类 文件 
PRA FARE: 
package com.mydomain.tetris.storage 


import android.content.Context 
import android.content.SharedPreferences 


class AppPreferences(ctx: Context) { 


var data: SharedPreferences - ctx.getSharedPreferences 
("APP PREFERENCES", Context.MODE PRIVATE) 


fun saveHighScore(highScore: Int) ( 
data.edit().putInt("HIGH SCORE", highScore).apply() 
} 
fun getHighScore(): Int { 
return data.getInt ("HIGH SCORE", 0) 


fun clearHighScore() { 
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data.edit().putInt("HIGH SCORE", 0).apply() 
} 

} 

在 上 述 代码 片段 中 ， 当 生成 类 实例 时 ， 需 要 向 类 的 构造 方法 中 传递 Context， 进 而 可 
访问 getSharedPreferences(0 方 法 ， 该 方法 将 获取 特定 的 预 置 文件 。 另 外 ， 该 文件 可 通过 字 
符 串 名 称 〈 即 传递 至 getSharedPreferences() 方 法 中 的 第 一 个 参数 ) 被 识别 。 

saveHighScoreO 函 数 接收 一 个 整数 参数 ， 即 所 保存 的 最 高 积分 值 ， 并 作为 该 方法 的 唯 
一 参数 。data.edit0 将 返回 一 个 Editor 对 象 ， 进 而 可 修改 预 置 文件 。 当 存储 预 置 文件 中 的 
整数 时 ， 可 调用 编辑 器 的 putInt0 方 法 。 其中， 传递 至 putInt0 方 法 中 的 第 一 个 参数 表示 为 
键 字符 串 ， 用 于 访问 相应 的 存储 值 。 该 方法 的 第 二 个 参数 为 整数 值 ， 当 前 表示 为 所 存储 
的 最 高 积分 值 。 

通过 调用 data.getInt() 、getHighScore0 方 法 将 返回 高 积分 值 。 这 里 ，getInt0 函 数 由 
SharedPreferences 实现 ， 并 提供 了 整数 存储 值 的 读 取 访问 操作 。HIGH_SCORE 则 表示 为 
检索 值 的 唯一 标识 符 。 其 中 ,传递 至 该 函数 中 的 第 二 个 参数 0 定义 了 所 返回 的 默认 值 一 一 此 
时 不 存在 与 特定 键 对 应 的 数值 。 

clearHighScore() 将 分 值 重 置 为 0。 也 就 是 说 ， 简 单 地 利用 0 值 覆 写 与 HIGH SCORE 
键 对 应 的 数值 。 

目前 ，AppPreferences 工具 类 定义 完毕 ， 下 面 继续 完成 MainActivity 中 的 
onBtnResetScoreClickO 函 数 ， 如 下 所 示 : 

private fun onBtnResetScoreClick(view: View) ( 

val preferences = AppPreferences (this) 
preferences.clearHighScore() 

} 

当 单 击 高 分 值 重 置 按钮 时 ， 对 应 值 将 被 重 置 为 0。 当 执行 此 类 动作 时 ， 读 者 可 能 希望 
得 到 用 户 的 某 些 反 馈 。 对 此 ， 可 使 用 Snackbar 以 实现 这 一 功能 。 

当 在 Android 应 用 程序 中 使 用 Snackbar 类 时 ， 需 要 将 Android 设计 支持 库 依赖 项 添 
加 到 模块 级 的 构建 脚本 中 。 针 对 于 此 ， 可 在 build.gradle 的 依赖 项 闭 包 中 添加 下 列 代码 : 

implementation 'com.android.support:design:26.1.0' 

接 下 来 ， 模 块 级 别 的 build.gradle 脚本 如 下 所 示 : 

apply plugin: 'com.android.application" 

apply plugin: 'kotlin-android' 

apply plugin: 'kotlin-android-extensions' 


android ( 
compileSdkVersion 26 


第 2 章 构建 Android 应 用 程序 一 一 俄罗斯 方块 游戏 sgg 


buildToolsVersion "26.0.1" 
defaultConfig { 
applicationId "com.mydomain.tetris" 
minSdkVersion 15 
targetSdkVersion 26 
versionCode 1 
versionName "1.0" 
testInstrumentationRunner "android.support.test.runner 
-AndroidJUnitRunner" 


} 
buildTypes { 
release { 
minifyEnabled false 
proguardFiles getDefaultProguardFile('proguard-android.txt'), 
'proguard-rules.pro' 


dependencies { 
implementation fileTree(dir: 'libs', include: ['*.jar']) 
implementation "org.jetbrains.kotlin: 
kotlin-stdlib-jre7:$kotlin version" 
implementation 'com.android.support:appcompat-v7:26.1.0' 
implementation 'com.android.support.constraint: 
constraint-layout:1.0.2" 
testImplementation 'junit:junit:4.12" 
androidTestImplementation 'com.android.support.test:runner:1.0.1"' 
androidTestImplementation 'com.android.support.test.espresso:espressocore: 
SORS 
implementation 'com.android.support:design:26.1.0" 
// adding android design support library 
) 


在 修改 完毕 之 后 , 单 击 编辑 器 窗口 显示 消息 中 的 Sync Now 按钮 , 即 可 同步 当前 项 目 ， 
如 图 2.16 所 示 。 


Ws Tetris ) Be app ) © build gredie ) A Moo PSL REALE OAL 


LE - 0+ o r cm HI ae : e 
"Wee Gradle files have changed since sync. A project sync may be necessary for the IDE to work properly. SycNow § 
> Mmanifests po" bd 
Y Majava [dependencies t) 
v Bacom.mydomain.tetris 1 apply plugin: 'com.android.application* v 
> storage : 


apply plugin: "kotlin-android- 


图 2.16 同步 当前 项 目 
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下 面 修改 onBtnResetClick0 方 法 ， 在 执行 了 积分 榜 重 置 后 ， 将 以 Snackbar 的 形式 提 
供用 户 反馈 信息 ， 如 下 所 示 : 


private fun onBtnResetScoreClick(view: View) { 


val preferences - AppPreferences (this) 

preferences.clearHighScore() 

Snackbar.make(view, "Score successfully reset", 
Snackbar.LENGTH SHORT) .show() 


ti RESET SCORE 按钮 即 可 成 功 地 重 置 玩家 的 高 分 积分 榜 ， 如 图 2.17 所 示 。 


TETRIS 


High score: 0 


图 2.17 重 置 玩家 的 高 分 积分 榜 


在 进一步 讨论 之 前 ， 还 需要 更 新 显示 于 MainActivity 中 的 、 高 积分 文本 视图 中 的 文本 
内 容 ， 并 体现 相应 的 重 置 分 数 。 这 可 通过 修改 文本 视图 中 的 文本 内 容 加 以 实现 ， 如 下 所 示 : 


private fun onBtnResetScoreClick(view: View) { 
val preferences = AppPreferences (this) 
preferences.clearHighScore() 
Snackbar.make(view, "Score successfully reset", 
Snackbar.LENGTH SHORT).show() 
tvHighScore?.text = "High score: ${preferences.getHighScore() }" 


} 
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2.3.8 实现 游戏 活动 布局 


当前 ， 我 们 已 经 创建 了 主 活动 布局 。 在 结束 本 章 之 前 ， 还 有 必要 针对 GameActivity 
构建 布局 。 对 此 ， 可 打开 activity game.xml 文件 ， 并 添加 下 列 代码 : 


«?xml version-"1.0" encoding-"utf-8"?» 
Xandroid.support.constraint.ConstraintLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
xmlns:app-"http://schemas.android.com/apk/res-auto" 
xmlns:tools-"http://schemas.android.com/tools" 
android:layout width-"match parent" 
android:layout height-"match parent" 
tools:context-"com.mydomain.tetris.GameActivity"» 
<LinearLayout 
android:layout width-"match parent" 
android:layout height-"match parent" 
android:orientation-"horizontal" 
android:weightSum-"10" 
android:background-"$e8e8e8"» 
<LinearLayout 
android: layout_width="wrap_ content" 
android:layout height-"match parent" 
android:orientation-"vertical" 
android:gravity-"center" 
android:paddingTop-"32dp" 
android:paddingBottom-"32dp" 
android:layout weight-"1"» 
<LinearLayout 
android: layout_width="wrap_ content" 
android:layout height="0dp" 
android:layout weight="1" 
android:orientation-"vertical" 
android:gravity="center"> 
<TextView 
android: layout_width="wrap_ content" 
android:layout height="wrap content" 
android:text="@string/current_score" 
android: textAllCaps="true" 
android:textStyle="bold" 
android:textSize-"14sp"/» 
<TextView 
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android:id="@+id/tv current score" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:textSize-"18sp"/» 

«TextView 
android:layout width-"wrap content" 
android:layout height-"wrap content" 


android: layout_marginTop="@dimen/layout_margin_top 


android:text="@string/high score" 
android:textAllCaps-"true" 
android:textStyle-"bold" 
android:textSize-"14sp"/» 
<TextView 
android:id="@+id/tv high score" 
android: layout_width="wrap content" 
android:layout height="wrap content" 
android: textSize="18sp"/> 
</LinearLayout> 
<Button 
android:id="@+id/btn restart" 
android:layout width="wrap content" 
android:layout height-"wrap content" 
android:text="@string/btn restart"/» 
</LinearLayout> 
<View 
android: layout_width="1dp" 
android: layout height="match parent" 
android: background="#000"/> 
<LinearLayout 
android: layout_width="0dp" 
android: layout_height="match_ parent" 
android:layout weight="9"> 
</LinearLayout> 
</LinearLayout> 
</android.support.constraint.ConstraintLayout> 
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background 和 android:layout weightSum 属性 。 

android:background 属性 用 于 设置 视图 或 视图 组 的 背景 颜色 。 相 应 地 
作为 值 传递 至 两 个 实例 中 ，android:background 则 用 于 当前 布局 中 。 这 本 
为 灰色 的 十 六 进 制 颜色 代码 ， 而 #000 则 表示 黑色 代码 。 


外 情况 是 android: 


, #e8e8e8 4114000 
E, #e8e8e8 表示 


android:layout weightSum 定义 了 视图 组 中 的 最 大 权 值 和 ， 其 计算 方式 为 : 视图 组 中 
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所 有 子 视图 的 layout weight (27 f. activity game.xml 中 的 第 一 个 线性 布局 将 全 部 子 视 
图 的 权 值 和 声明 为 10。 因 此 ， 线 性 布局 的 直接 子 元 素 分 别 包含 了 1 和 9 的 布局 权 值 。 

此 处 使 用 了 3 个 字符 串 资 源 ， 且 之 前 尚未 添加 至 字符 串 资 源 文件 中 。 下 面 将 下 列 字 
符 串 资源 添加 至 strings.xml 中 ， 如 下 所 示 : 


«string nam 


high score">High score</string> 
<string name="current score">Current score</string> 
«string name-"btn restart">Restart</string> 


最 后 ， 对 于 高 分 积分 榜 以 及 当前 积分 文本 视图 ， 还 需要 向 游戏 活动 中 加 入 一 些 简单 
的 逻辑 ， 如 下 所 示 : 


package com.mydomain.tetris 


import android.os.Bundle 

import android.support.v7.app.AppCompatActivity 
import android.widget.Button 

import android.widget.TextView 

import com.mydomain.tetris.storage.AppPreferences 


class GameActivity: AppCompatActivity() { 


var tvHighScore: TextView? = null 
var tvCurrentScore: TextView? - null 
var appPreferences: AppPreferences? - null 


public override fun onCreate(savedInstanceState: Bundle?) ( 
super.onCreate (savedInstanceState) 
setContentView(R.layout.activity game) 
appPreferences - AppPreferences (this) 


val btnRestart = findViewById«Button» (R.id.btn restart) 


tvHighScore = findViewById«TextView» (R.id.tv high score) 
tvCurrentScore = findViewById«TextView»(R.id.tv current score) 


updateHighScore() 
updateCurrentScore () 


private fun updateHighScore() { 
tvHighScore?.text = "${appPreferences?.getHighScore() }" 
} 
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Private fun updateCurrentScore () { 
tvCurrentScore?.text = "0" 
} 
} 


在 上 述 代 码 片 段 中 ， 生 成 了 指向 布局 视图 元 素 的 对 象 引 用 。 除 此 之 外 ， 还 声明 了 
updateHighScore0 和 updateCurrentScore() 函 数 ， 这 两 个 函数 在 生成 视图 时 被 调用 ， 并 将 默 
认 的 分 值 显示 于 当前 分 值 中 ， 同 时 将 布局 文件 中 的 高 分 值 设置 于 文本 视图 中 。 


保存 修改 后 的 项 目 ， 构 建 并 运行 当前 应 用 程序 。 当 应 用 程序 显示 所 创建 的 布局 时 ， 
单 击 NEW GAME 按钮 ， 如 图 2.18 所 示 。 


Tetris 


图 2.18 所 创建 的 布局 


布局 右 侧 当前 未 包含 任何 内 容 ， 同 时 ， 这 也 是 游戏 的 体验 区 域 。 第 3 
部 分 内 容 。 最 后 一 项 需要 了 解 的 内 容 是 App 清单 文件 ， 


章 将 实现 这 一 
下 面 将 对 此 加 以 讨论 。 


2.4 App 清单 文件 


App 清单 文件 是 每 个 Android 应 用 程序 均 包 含 的 XML 文件 , 并 位 于 应 用 程序 根 文件 
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夹 的 清单 文件 中 。 清单 文件 加 载 了 与 Android 操作 系统 的 应 用 程序 相关 的 重要 信息 。 在 应 
用 程序 运行 之 前 ，Android 系统 需要 读 取 应 用 程序 的 androidManifest.xml 文件 中 的 信息 。 
其 中 ， 需 要 在 App 清单 文件 中 注册 的 一 些 信息 包括 以 下 方面 : 
应 用 程序 的 Java & 4. 
应 用 程序 中 的 活动 。 
用 于 应 用 程序 中 的 服务 。 
将 隐 式 意图 转发 至 某 个 活动 的 意图 过 滤器 。 
用 于 应 用 程序 中 的 广播 接收 者 的 描述 。 
应 用 程序 中 与 内 容 提供 商 相关 的 数据 。 
实现 了 各 种 应 用 程序 组 件 的 类 。 
应 用 程序 所 需 的 授权 。 
下 列 代码 片段 展示 了 androidManifestxml 文件 的 一 般 结 构 ， 其 中 包含 了 清单 文件 中 
所 有 的 元 素 和 声明 。 


<?xml version-"1.0" encoding-"utf-8"?» 
«manifest» 


DOOOOOODD 


<uses-permission /> 
Xpermission /> 
<permission-tree /> 
<permission-group /> 
<instrumentation /> 
<uses-sdk /> 
<uses-configuration /> 
<uses-feature /> 
<supports-screens /> 
<compatible-screens /> 
<supports-gl-texture /> 


«application» 
«activity» 
<intent-filter> 
<action /> 
<category /> 
<data /> 
</intent-filter> 
<meta-data /> 
</activity> 
<activity-alias> 
<intent-filter> 


*80* Kotlin 语言 实例 精 解 


</intent-filter> 
<meta-data /> 

</activity-alias> 

<service> 
<intent-filter> 
</intent-filter> 
«meta-data/» 

</service> 

<receiver> 
<intent-filter> . . . </intent-filter> 
<meta-data /> 

</receiver> 

<provider> 
Xgrant-uri-permission /> 
<meta-data /> 
<path-permission /> 

</provider> 

<uses-library /> 

</application> 
</manifest> 


不 难 发 现 ， 清 单 文件 中 涵盖 了 大 量 的 元 素 ， 本 书 将 对 其 中 的 大 部 分 内 容 予 以 介绍 。 
实际 上 ， 当 前 俄罗斯 方块 游戏 中 已 经 涉及 了 部 分 清单 元 素 。 读 者 可 打开 该 游戏 的 
androidManifest.xml 文件 ， 对 应 内 容 如 下 所 示 : 


<?xml version-"1.0" encoding-"utf-8"?» 
«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package="com.mydomain.tetris"> 
<application 
android:allowBackup-"true" 
android:icon="@mipmap/ic launcher" 
android:label-"estring/app name" 
android:roundIcon-"G8mipmap/ic launcher round" 
android:supportsRtl-"true" 
android: theme="@style/AppTheme"> 
<activity android:name=".MainActivity"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
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</activity> 
<activity android:name-".GameActivity" /> 
</application> 


</manifest> 


清单 文件 中 的 元 素 采用 字母 顺序 排列 ， 其 中 包括 以 下 方面 : 
<action>。 

<activity>. 

<application>. 

<category> « 

<intent-filter>. 


OCOOCOCOC x 


<manifest>. 
2.4.4 «action» 


<action> 用 于 向 意图 过 滤器 中 添加 某 个 动作 ， 该 元 素 通常 是 <intent-filter> 元 素 的 子 元 
素 。 意 图 过 滤器 应 包含 一 个 或 多 个 此 类 元 素 。 若 未 针对 意图 过 滤器 声明 action 元 素 ， 该 
过 滤器 将 不 会 接收 Intent 对 象 ， 对 应 语法 格式 如 下 所 示 : 


<action name=""/> 


上 述 name 属性 指定 了 所 处 理 的 action 的 名 称 。 
2.4.2 <activity> 


该 元 素 声明 了 应 用 程序 中 的 一 个 活动 。 全 部 活动 都 需要 在 App 清单 文件 中 加 以 声明 ， 
以 使 Android 系统 对 此 有 所 了 解 。<activity> 通 常 置 于 父 <application> 元 素 中 。 下 列 代码 片 
段 通过 <activity> 元 素 在 清单 文件 中 显示 了 活动 声明 。 

<activity android:name-".GameActivity" /> 


其 中 ，name 属性 用 于 指定 实现 了 所 声明 活动 的 类 名 。 


2.4.3 <application> 


该 元 素 表示 为 应 用 程序 声明 ， 并 包含 了 子 元 素 以 声明 应 用 程序 中 的 组 件 。 下 列 代码 
显示 了 <application> 的 使 用 方式 。 
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«application 
android:allowBackup-"true" 
android:icon="@mipmap/ic launcher" 
android: label="@string/app_ name" 
android: roundIcon="@mipmap/ic_launcher_round" 
android: supportsRtl="true" 
android: theme="@style/AppTheme"> 
<activity android:name=".MainActivity"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
<activity android:name=".GameActivity" /> 


</application> 


上 述 代 码 片段 中 的 <application> 元 素 使 用 了 6 个 属性 ， 如 下 所 示 。 


a 
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android:allowBackup: 用 于 确定 应 用 程序 是 否 参与 备份 和 恢复 基础 结构 。 当 该 属 
性 设置 为 true 时 ， 当 前 应 用 程序 将 通过 Android 系统 备份 ; 否则 ，Android 系统 
将 不 会 生成 应 用 系统 备份 。 

android:icon: 用 于 确定 应 用 程序 的 图 标 资源 ， 除 此 之 外 ， 还 用 于 确定 应 用 程序 
组 件 的 图 标 资源 。 

android:label: 整体 上 用 于 确定 应 用 程序 的 默认 标记 。 此 外 ， 还 用 于 确定 应 用 程 
序 组 件 的 默认 标记 。 

android:roundIcon: 当 需 要 使 用 到 圆 形 图 标 资源 时 , 该 属性 用 于 确定 所 用 的 图 标 。 
当 启 动 程序 请 求 使 用 App 图 标 时 ，Android 框架 将 返回 android:icon 或 android: 
roundIcon， 有 具体 返回 内 容 取决 于 设备 构建 配置 。 由 于 可 返回 二 者 中 的 一 个 图 标 ， 
因而 须 针对 两 个 属性 指定 一 个 资源 。 

android:supportsRtl: 该 属性 用 于 确定 应 用 程序 是 否 支 持 自 右 向 左 (RTL) 布局 。 
当 该 属性 设置 为 true 时 ， 应 用 程序 将 支持 此 类 布局 方式 ;和 否则， 应 用 程序 将 不 
支持 RTL 布局 。 
android:theme: 该 属性 针对 应 用 程序 中 的 所 有 活动 , 确定 了 定义 默认 主题 的 样式 


<category> 


该 元 素 表 示 为 <intent-filter> 的 子 元 素 ， 用 于 确定 其 父 意图 过 滤器 组 件 的 分 类 名 称 。 
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2.4.5 <intent-filter> 


该 元 素 用 于 确定 活动 、 服 务 、 广 播 接收 者 组 件 所 响应 的 意图 类 型 。 意 图 过 滤器 通常 
在 包含 <intent-filter> 元 素 的 父 组 件 中 加 以 声明 。 


2.4.6 «manifest» 


«manifest AR 7J App 清单 文件 的 根 元 素 ， 其 中 包含 了 单一 的 <application> 元 素 ， 并 
确定 了 xmlns:android 和 数据 包 属 性 。 


25 本 章 小 结 


本 章 考察 了 Android 应 用 程序 框架 ， 其 中 涉及 7 种 基本 的 Android App 组 件 : 活动 、 
意图 、 意 图 过 滤器 、 片 段 、 服 务 、 加 载 器 以 及 内 容 提 供 商 。 

除 此 之 外 ， 本 章 还 介绍 了 布局 的 构建 过 程 、 约 束 布 局 、 布 局 约束 类 型 、 字 符 串 、 尺 
寸 资源 、 视 图 、 视 图 组 以 及 与 SharedPreferences 的 协同 工作 方式 。 第 3 章 将 深入 讨论 俄 
罗斯 方块 游戏 的 场景 ， 并 实现 游戏 操作 以 及 应 用 程序 逻辑 。 


第 3 章 ”俄罗斯 方块 游戏 的 逻辑 和 功能 


第 2 章 讨论 了 与 经 典 游戏 俄罗斯 方块 相关 的 一 些 内容 ， 制 定 了 应 用 程序 的 布局 ， 并 
实现 了 所 设置 的 布局 元 素 。 其 中 ， 我 们 针对 应 用 程序 创建 了 两 个 活动 ， 即 MainActivity 
和 GameActivity。 除 此 之 外 ， 还 实现 了 视图 的 基本 特征 和 行为 ， 但 并 未 涉及 App 的 核心 
体验 过 程 ， 本 章 将 完成 这 一 功能 ， 主 要 包括 以 下 内 容 : 

口 异常 处 理 。 
Q MVP 模式 。 


3.1] ”实现 游戏 体验 过 程 


关于 游戏 的 体验 过 程 ， 本 章 主要 考察 GameActivity。 图 3.1 显示 了 与 此 对 应 的 效果 。 


图 3.1 GameActivity 的 最 终 效果 


待 了 解 了 游戏 体验 过 程 的 最 终 效 果 后 ， 下 面 开始 介绍 具体 的 开发 过 程 。 
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在 第 2 章 中 ， 曾 讨论 了 基于 贴图 的 图 块 匹配 游戏 ， 此 类 贴图 经 组 合 后 可 形成 较 大 的 
图 块 。 这 里 ， 图 块 由 4 个 正方 形 图 案 组 成 ， 且 彼此 垂直 连接 。 


3.1.1 图 块 建 模 


图 块 对 于 俄罗斯 方块 游戏 来 说 十 分 重要 ， 需 要 通过 编程 方式 对 此 类 元 素 进行 建 模 。 
对 此 ， 可 将 每 个 图 块 视 为 构造 块 。 构 造 块 包含 了 一 组 特性 ， 并 可 归 类 至 不 同 的 特征 和 行 
为 中 。 

1. 构造 块 特征 

下 列 内 容 体现 了 构造 块 所 包含 的 某 些 特征 。 
D “形状 ; 图 块 均 包含 固定 的 形状 且 无 法 被 修改 。 
口 尺寸 : 图 块 包含 尺寸 特征 ， 即 高 度 和 宽度 。 

O Hi: 图 块 通常 会 涵盖 某 种 颜色 ， 对 应 元 素 不 会 发 生 改变 ， 并 在 图 块 的 存在 过 

程 中 进行 维护 。 

O 位 置 特征 ， 在 任意 时 刻 ， 图 块 均 包 含 -X 和 YY 轴 上 的 位 置 。 

2. 图 块 的 行为 

图 块 的 主要 行为 体现 在 其 独特 的 运动 上 ， 包 括 平移 和 旋转 操作 。 其 中 ， 平 移 运动 指 
的 是 空间 两 点 间 的 直线 运动 。 在 俄罗斯 方块 中 ， 图 块 可 实现 左 移 、 右 移 以 及 下 移 操作 。 
另外 ， 旋 转 也 是 刚体 运动 中 的 一 种 运动 类 型 。 也 就 是 说 ， 旋 转运 动 涉及 自由 空间 内 的 对 
象 的 旋转 行为 。 在 俄罗斯 方块 游戏 中 ， 所 有 的 图 块 均 可 实现 旋转 运动 。 

在 了 解 了 基本 的 图 块 特征 和 行为 后 , 读者 可 能 会 产生 疑问 : 如 何 构成 此 类 块 状 图 案 ? 
注意 ， 全 部 图 块 特征 均 应 用 于 一 个 图 块 上 ， 其 中 涉及 以 下 两 项 内 容 : 

口 图 块 由 4 个 贴图 构成 。 

Q ”图 块 中 的 全 部 贴图 彼此 垂直 排列 。 

下 面 将 上 述 特征 转换 为 程序 模型 ， 且 仍然 从 形状 建 模 开 始 讨论 。 

3. 图 块 形状 建 模 
形状 建 模 方法 取决 于 多 种 情况 ， 例 如 须 测量 的 形状 类 型 ， 以 及 在 空间 维度 中 建 模 的 
特定 形状 。 

与 二 维 形状 建 模 相 比 ， 三 维 形状 建 模 则 较为 困难 。 在 俄罗斯 方块 中 ， 图 块 建 模 主要 
在 二 维 环境 下 进行 。 在 开始 采用 编程 方式 建 模 之 前 ， 需 要 了 解 即将 建 模 的 实际 形状 。 俄 
罗斯 方块 游戏 存在 7 种 基本 的 图 块 ， 即 图 3.2 中 的 O、I_T、L、J SIZ. 
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图 3.2 游戏 中 的 基本 图 块 


上 述 形状 占据 了 边缘 构成 的 边界 ， 对 应 形状 所 涉及 的 空间 区 域 可 视 为 一 个 轮廓 线 ， 
这 与 相框 中 的 相片 有 几 分 类 似 。 相 应 地 ， 我 们 需要 对 此 进行 建 模 ， 进 而 包含 独立 的 形状 。 
鉴于 图 块 形状 的 二 维特 征 ， 此 处 可 采用 二 维 字 节 数组 加 载 图 框 信息 。 其 中 ， 字 节 表 示 为 
信息 的 数位 单元 ， 一 般 由 8 位 组 成 ， 且 每 一 位 表示 为 二 进 制 位 。 在 计算 机 中 ， 这 也 是 最 
小 的 数据 单元 ， 对 应 值 为 0 或 1。 

对 应 思想 可 描述 为 : 使 用 一 个 二 维 数组 对 形状 图 框 建 模 ， 图 框 所 覆盖 的 区 域 ， 其 字 
节 值 为 1， 而 那些 没有 被 它 覆 盖 的 区 域 ， 对 应 值 为 0。 考察 图 3.3 中 的 图 块 。 

这 里 ， 可 以 将 该 形状 视 为 字 节 的 二 维 数组 ， 其 中 包含 了 两 行 3 列 ， 如 图 3.4 所 示 。 
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图 3.3 图 块 图 3.4 图 块 的 二 维 数组 


字 节 值 1 被 赋予 数组 单元 中 ， 并 以 此 构成 了 图 框 的 形状 。 另 外 一 方面 ， 字 节 值 0 则 
不 属于 图 框 形状 。 当 采用 类 时 ， 建 模 过 程 变 得 十 分 简单 。 首先， 需要 定义 一 个 函数 以 生 
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成 所 需 的 字 节 数组 结构 ， 并 用 于 存储 图 框 字 节 。 另 外 ， 还 可 在 资源 数据 包 中 创建 一 个 新 
的 数据 包 ， 并 将 其 命名 为 helpers。 在 该 数据 包 中 ， 生 成 一 个 文件 HelperFunctions.kt， 其 
中 包含 开发 该 App 过 程 中 的 全 部 帮助 函数 。 随 后 ， 打 开 HelperFunctions.kt 文件 ， 并 向 该 
文件 中 输入 下 列 代码 : 


package com.mydomain.tetris.helpers 


fun array2dOfByte(sizeOuter: Int, sizeInner: Int): Array<ByteArray> 
= Array(sizeOuter) { ByteArray(sizeInner) } 


上 述 代 码 定义 了 array2dOfByte0 函 数 ， 该 函数 接收 两 个 参数 。 其 中 ， 第 一 个 参数 表 
示 数 组 的 行 数 ， 第 二 个 参数 则 表示 为 字 节 数组 的 列 数 。array2dOFByte0 方 法 生成 并 返 
包含 特定 属性 的 新 数组 。 下 面 将 尝试 定义 Frame 类 ， 并 在 资源 数据 包 中 创建 一 个 新 的 数 
据 包 , 同时 将 其 命名 为 models. 全 部 对 象 模型 均 在 该 数据 包 内 打包 。 在 models 数据 包 中 ， 
在 文件 Frame.kt 中 定义 Frame 类 ， 并 输入 下 列 代码 : 


package com.mydomain.tetris.models 


import com.mydomain.tetris.helpers.array2dOfByte 


class Frame(private val width: Int) ( 
val data: ArrayList<ByteArray> = ArrayList() 


fun addRow(byteStr: String): Frame { 
val row = ByteArray (byteStr.length) 


for (index in byteStr.indices) ( 
row[index] = "${byteStr[index]}".toByte() 

} 

data.add (row) 

return this 


} 


fun as2dByteArray(): Array<ByteArray> { 
val bytes = array2dOfByte(data.size, width) 
return data.toArray (bytes) 
} 
} 


Frame 类 包含 了 两 个 属性 ， 即 width 和 data. HH, width 表示 为 一 个 整数 属性 ， 并 
加 载 图 框 的 宽度 值 ( 即 图 框 字 节 数组 中 的 列 数 ) 。data 属性 则 加 载 ByteArray 值 空间 中 的 
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元 素数 组 列表 。 另 外 ， 函 数 addRowQ/fll get). addRow0 接 收 一 个 字符 串 参数 ， 并 将 每 个 
字符 串 字 符 转 换 为 字 节 表达 ， 随 后 将 字 节 表达 结构 添加 至 字 节 数 组 中 。 接 下 来 ， 该 字 节 
数组 将 添加 至 数据 列表 中 。get0 方 法 将 数据 数组 列表 转换 为 字 节 数组 ， 并 返回 该 数组 。 

一 旦 图 框 建 模 完 毕 并 加 载 了 图 块 后 ， 即 可 对 游戏 中 的 各 种 形状 建 模 。 对 此 ， 可 使 用 
enum 类 。 在 此 之 前 ， 可 在 模块 数据 包 中 创建 a Shape.kt 文件 ， 并 首先 对 图 3.5 所 示 的 形 
状 建 模 。 


图 3.5 对 图 块 形状 建 模 
如 前 所 述 ， 可 将 图 框 视 作 二 维 字 节 数组 。 具 体 来 说 ， 该 字 节 数组 包含 了 4 行 1 列 数 
据 ， 且 每 个 单元 格 中 利用 字 节 值 1 进行 填充 。 据 此 ， 即 可 对 当前 形状 建 模 。 在 Shape.kt 
文件 中 ， 可 定义 一 个 Shape 枚 举 类 ， 如 下 所 示 : 


enum class Shape(val frameCount: Int, val startPosition: Int) ( 
Tetromino(2, 2) ( 
override fun getFrame(frameNumber: Int): Frame ( 
return when (frameNumber) { 
0 -» Frame(4).addRow("1111") 
1 -» Frame(1) 
-addRow ("1") 
-addRow ("1") 
-addRow ("1") 
-addRow ("1") 
else -> throw IllegalArgumentException ("$frameNumber is an invalid 
frame number.") 
} 
} 
5 
abstract fun getFrame(frameNumber: Int): Frame 


} 
enum 类 的 声明 方式 可 描述 为 :在 class 关键 字 之 前 放置 enum KHZ. Shape 枚 举 类 
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的 主 构造 方法 接收 两 个 参数 。 其 中 ， 第 一 个 参数 为 frameCount， 该 整数 值 指定 了 形状 中 
的 图 框 数量 。 第 二 个 参数 为 startPosition, 用 于 确定 对 应 形状 在 义 轴 上 的 起 始 位 置 ,在 enum 
类 文件 中 ， 还 声明 了 一 个 getFrame0 函 数 。 注 意 ， 该 函数 使 用 了 abstract 关键 字 。 抽 象 函 
数 不 包含 任何 实现 《因而 不 包含 函数 体 ) ， 并 用 于 抽象 某 种 行为 ， 随 后 的 扩展 类 须 对 此 
予以 实现 。enum 类 中 的 对 应 代码 如 下 所 示 : 
Tetromino(2, 2) { 
override fun getFrame (frameNumber: Int): Frame { 
return when (frameNumber) { 


0 -> Frame (4) .addRow ("1111") 
1 -> Frame (1) 


-addRow ("1") 
-addRow ("1") 
-addRow ("1") 
-addRow ("1") 
else -> throw IllegalArgumentException("$frameNumber is an invalid 
frame number.") 
) 
) 

) 

在 上 述 代码 块 中 ，enum 实例 提供 了 抽象 函数 的 具体 实现 。 该 实例 的 标识 符 为 
Tetromino。 作 为 参数 ， 可 将 整数 值 2 传递 至 Tetromino 构造 方法 中 的 frameCount 和 
startPosition 属性 。 除 此 之 外 ，Tetromino 还 提供 了 getFrame0 函 数 实现 ， 即 覆 写 Shape 所 
声明 的 getFrame0 函 数 。 相应 地 , 通过 override 关键 字 , 可 实现 函数 的 覆 写 操作 。Tetromino 
中 的 getFrame0 函 数 接收 一 个 frameNumber 整数 ， 进 而 指定 了 所 返回 的 Tetromino KIHE. 
读者 可 能 会 对 此 感到 疑问 : 为 何 Tetromino 可 包含 多 个 图 框 ? 这 仅仅 是 图 块 旋 转 效果 所 
致 。 之 前 看 到 的 单列 图 块 可 实现 左旋 或 右 旋 ， 进 而 可 得 到 如 图 3.6 所 示 的 效果 。 


[suma] 


图 3.6 图 块 的 旋转 


若 传 递 至 getFrame0O 函 数 中 的 frameNumber 为 0，getFrame() 函 数 将 返回 一 个 Frame 
对 象 ， 该 对 象 针 对 水 平 状态 的 Tetromino 图 框 建 模 。 若 frameNumber 为 1， 则 返回 垂直 状 
态 下 的 图 框 对 象 。 

如 果 frameNumber 既 不 为 0, 也 不 为 1, 那么 , 函数 将 抛 出 IllegalArgumentException。 
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0 zz. 
除了 作为 一 个 对 象 之 外 ，Tetromino 也 可 表示 为 一 个 常量 。 一 般 情 况 下 ，enum 类 常 
用 于 定义 常量 。 由 于 需要 实现 固定 的 形状 集合 ， 因 而 enum 类 非常 适合 对 图 块 形状 建 模 。 


当 理 解 了 Shape 类 的 工作 方式 后 ， 即 可 对 图 块 形状 建 模 ， 如 下 所 示 : 


enum class Shape(val frameCount: Int, val startPosition: Int) ( 


下 面 通过 单一 图 框 且 起 始 位 置 为 1 创建 图 块 形状 。 这 里 建 模 的 图 块 表示 为 正方 形 或 
者 “O” 形 状 的 图 块 ， 如 下 所 示 : 


Tetrominol(1, 1) ( 
override fun getFrame(frameNumber: Int): Frame ( 
return Frame (2) 
-addRow ("11") 
-addRow ("11") 


} 
}, 


下 面 利 用 两 个 图 框 构建 图 块 形状 ， 且 起 始 位 置 为 1。 此 处 建 模 的 图 块 为 “Z” 形 状 的 
图 块 ， 如 下 所 示 : 
Tetromino2(2, 1) ( 
override fun getFrame(frameNumber: Int): Frame ( 
return when (frameNumber) { 
0 -> Frame (3) 
-addRow ("110") 
-addRow ("011") 
1 -> Frame (2) 
-addRow ("01") 
-addRow ("11") 
-addRow ("10") 
else -> throw IllegalArgumentException("$frameNumber is an invalid 
frame number.") 


Nr 
下 面 利 用 两 个 图 框 ， 且 起 始 位 置 为 1 生成 图 块 形状 。 这 里 ， 建 模 图 块 表示 为 “S” 形 
状 图 块 ， 如 下 所 示 : 


Tetromino3(2, 1) ( 
override fun getFrame(frameNumber: Int): Frame { 
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return when (frameNumber) { 
0 -> Frame (3) 
-addRow ("011") 
-addRow ("110") 
1 -> Frame (2) 
-addRow ("10") 
-addRow ("11") 
-addRow ("01") 
-> throw IllegalArgumentException ("$frameNumber is 


else 
an invalid frame number.") 


}, 


下 面 利 用 两 个 图 框 ， 且 起 始 位 置 为 2 创建 图 块 。 这 里 ， 建 模 图 块 表示 为 “T” 形 图 块 ， 
如 下 所 示 : 
Tetromino4(2, 2) ( 
override fun getFrame(frameNumber: Int): Frame ( 
return when (frameNumber) { 
0 -> Frame (4) .addRow("1111") 
1 -> Frame (1) 
.addRow ("1") 
-addRow ("1") 
-addRow ("1") 
-addRow ("1") 


else -> throw IllegalArgumentException("$frameNumber is an 
invalid frame number.") 


) 
}, 


下 面 利用 4 个 图 框 ， 且 起 始 位 置 为 1 创建 图 块 。 这 里 ， 建 模 图 块 表示 为 “T” 形 图 块 ， 
如 下 所 示 : 


Tetromino5(4, 1) ( 
override fun getFrame(frameNumber: Int): Frame { 


return when (frameNumber) { 


0 -> Frame (3) 
-addRow ("010") 
-addRow ("111") 
1 -> Frame (2) 
-addRow ("10") 
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-addRow ("11") 
-addRow ("10") 
2 -» Frame(3) 
-addRow ("111") 
-addRow ("010") 
3 -> Frame (2) 
-addRow ("01") 
-addRow ("11") 
-addRow ("01") 
else -> throw IllegalArgumentException("$frameNumber is an 
invalid frame number.") 


} 
}, 


下 面 利用 4 个 图 框 ， 且 起 始 位 置 为 1 创建 图 块 。 这 里 ， 建 模 图 块 表示 为 “J” 形 状 的 
图 块 ， 如 下 所 示 : 


Tetromino6(4, 1) ( 
override fun getFrame(frameNumber: Int): Frame ( 
return when (frameNumber) { 
0 -> Frame (3) 
-addRow ("100") 
-addRow ("111") 
1 -> Frame (2) 
-addRow ("11") 
-addRow ("10") 
-addRow ("10") 
2 -» Frame(3) 
-addRow ("111") 
-addRow ("001") 
3 -> Frame (2) 
-addRow ("01") 
-addRow ("01") 
-addRow ("11") 
else -> throw IllegalArgumentException ("$frameNumber is 
an invalid frame number.") 


b 
), 


下 面 利 用 4 个 图 框 ， 且 起 始 位 置 为 1 创建 图 块 。 这 里 ， 建 模 图 块 表示 为 “L ”形状 的 
图 块 ， 如 下 所 示 : 
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Tetromino7(4, 1) { 
override fun getFrame(frameNumber: Int): Frame { 
return when (frameNumber) { 
0 -> Frame (3) 
-addRow ("001") 
-addRow ("111") 
1 -» Frame(2) 
-addRow ("10") 
-addRow ("10") 
-addRow ("11") 
2 -» Frame(3) 
-addRow ("111") 
-addRow ("100") 
3 -> Frame (2) 
-addRow ("11") 
-addRow ("01") 
-addRow ("01") 
else -> throw IllegalArgumentException ("$frameNumber is 
an invalid frame number.") 


} 
he 


abstract fun getFrame(frameNumber: Int): Frame 


} 


在 对 方块 和 形状 建 模 后 ， 下 一 步 采 用 编程 方式 建 模 的 内 容 是 方块 自身 。 此 处 ， 将 展 
示 Kotlin 与 Java 之 间 的 无 颖 衔接 操作 ， 也 就 是 说 ， 通 过 Java 实现 建 模 过 程 ， 并 在 models 
目录 中 定义 名 为 Block 的 新 Java 类 (models | New | Java Class) 。 下 面 将 添加 相应 的 实例 
变量 ， 并 以 此 展现 方块 的 特征 。 考 察 下 列 代码 : 

package com.mydomain.tetris.models; 


import android.graphics.Color; 
import android.graphics.Point; 


public class Block ( 
private int shapeIndex; 
private int frameNumber; 
private BlockColor color; 
private Point position; 


public enum BlockColor ( 
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PINK(Color.rgb(255, 105, 180), (byte) 2), 
GREEN(Color.rgb(0, 128, 0), (byte) 3), 
ORANGE(Color.rgb(255, 140, 0), (byte) 4), 
YELLOW(Color.rgb(255, 255, 0), (byte) 5), 
CYAN(Color.rgb(0, 255, 255), (byte) 6); 
BlockColor(int rgbValue, byte value) ( 
this.rgbValue = rgbValue; 
this.byteValue = value; 
) 


private final int rgbValue; 
private final byte byteValue; 
} 

} 

在 上 述 代码 中 ， 我 们 加 入 了 4 个 实例 变量 ， 即 shapeIndex. frameNumber. color 和 
position。 其 中 ，shapeIndex 加 载 图 块 形状 的 索引 ; frameNumber 将 记录 图 块 形状 包含 的 
图 框 数量 ，color 则 加 载 图 块 的 颜色 特征 ， 而 position 用 于 记录 图 块 当前 的 空间 位 置 。 

同时 ，enum 模板 BlockColor 也 将 添加 至 Block 类 中 。enum 创建 了 一 个 BlockColor 
实例 常量 集 , 每 个 实例 均 包含 rgbValue 和 byteValue 属性 。 其 中 , rgbValue 表示 一 个 整数 ， 
并 唯一 标识 Color.rgb0 方 法 所 指定 的 RGB 颜色 .Color 则 是 Android 应 用 程序 框架 提供 的 
一 个 类 ， 而 rgb0 则 是 定义 于 Color 类 中 的 类 方法 。 相 应 地 ， 调 用 Colour.rgb0 方 法 5 次 将 
分 别 定义 粉色 、 绿 色 、 桶 黄色、 黄色 和 青色 。 

在 Block 类 中 ， 分 别 使 用 了 private 和 public 关键 字 。 这 些 关键 字 都 不 是 为 了 吸引 眼 
球 而 添加 的 ， 它 们 都 有 各 自 的 用 处 。private、public 连同 protected 关键 字 统 称 为 访问 修 
饰 符 。 

O zz: 

作为 一 类 关键 字 ， 访 问 修 饰 符 用 于 指定 类 、 方 法 、 函 数 、 变 量 和 结构 的 访问 限制 。 
Java 中 设置 了 3 种 访问 修饰 符 ， 即 private, public 和 protected, Æ Kotlin 中 ， 访 问 修饰 符 
也 称 作 可 见 性 修饰 符 ， 包 括 public, protected, private 和 internal. 


CL) 私有 访问 修饰 符 (private) 

声明 为 private 的 方法 、 变 量 、 构 造 方法 以 及 结构 仅 可 在 声明 类 中 被 访问 。 例 外 情况 
是 私有 顶级 (top-level) 函数 和 属性 ， 它 们 针对 同一 文件 中 的 所 有 成 员 均 为 可 见 。 类 中 的 
私有 变量 可 通过 声明 了 getter 和 setter 方法 〈 并 授权 访问 ) 的 外 部 类 进行 访问 。 在 Java 
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"P, setter 和 getter 的 定义 方式 如 下 所 示 : 


public class Person { 
Person(String fullName, int age) { 
this.fullName = fullName; 
this.age = age; 


} 


private String fullName; 
private int age; 


public String getFullName() { 
return fullName; 


} 


public int getAge() { 
return age; 
} 
} 


在 Kotlin 中 ，setter 和 getter 的 定义 如 下 所 示 : 


public class Person (private var fullName: String) { 
var name: String 
get() = fullName 
set(value) ( 
fullName - value 
) 
) 


使 用 private 访问 修饰 符 是 程序 中 数据 隐藏 的 主要 方式 。 信 息 隐藏 也 称 作 封装 。 

(2) 公有 访问 修饰 符 (public) 

声明 为 public 的 方法 、 变 量 、 构 造 方法 和 结构 可 在 声明 类 的 外 部 自由 地 被 访问 。 不 
同 数据 包 中 的 public 类 在 使 用 之 前 必须 被 导入 ， 下 列 类 使 用 了 public 访问 修饰 符 : 

public class Person { .. } 

(3) 保护 访问 修饰 符 Cprotected ) 

声明 为 受 保护 的 变量 、 方 法 、 函 数 和 结构 只 能 由 相同 包 中 的 类 访问 ， 或 者 由 子 类 访 
问 ， 这 些 类 存在 于 单独 的 包 中 ， 如 下 所 示 : 


public class Person(private var fullName: String) { 
protected name: String 
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get() = fullName 
set(value) { 
fullName = value 
} 
} 


(4) 内 部 可 见 性 修饰 符 

内 部 可 见 性 修饰 符 用 于 声明 同一 个 模块 (module) 内 可 见 的 成 员 。 这 里 ， 模 块 表示 
为 整体 编译 的 Kotlin 文件 集合 ， 例 如 一 个 Maven 项 目 、Gradle 资源 集合 、IntelliJ IDEA 
模块 ， 或 者 是 利用 Ant 任务 调用 编译 的 文件 集合 。internal 修饰 符 的 使 用 方式 与 其 他 可 见 
性 修饰 符 类 似 ， 如 下 所 示 : 


internal class Person { } 


在 读者 理解 了 访问 修饰 符 和 可 见 性 修饰 符 后 ， 即 可 继续 实现 Block 类 。 下 面 将 针对 
该 类 定义 一 个 构造 方法 , 并 将 所 创建 的 实例 变量 设置 为 初始 状态 。 从 句法 角度 来 看 ，Java 
中 的 构造 方法 定义 不 同 于 Kotlin, W FAIR: 

public class Block { 


private int shapeIndex; 
private int frameNumber; 


private BlockColor color; 
private Point position; 


构造 方法 定义 如 下 所 示 : 


private Block(int shapeIndex, BlockColor blockColor) { 
this.frameNumber - 0; 
this.shapeIndex = shapeIndex; 
this.color - blockColor; 
this.position = new Point (AppModel.FieldConstants 
.COLUMN COUNT.getValue() / 2, 0); 
) 


public enum BlockColor { 
PINK(Color.rgb(255, 105, 180), (byte) 2), 
GREEN(Color.rgb(0, 128, 0), (byte) 3), 
ORANGE (Color.rgb(255, 140, 0), (byte) 4), 
YELLOW(Color.rgb(255, 255, 0), (byte) 5), 
CYAN(Color.rgb(0, 255, 255), (byte) 6); 
BlockColor(int rgbValue, byte value) { 
this.rgbValue - rgbValue; 
this.byteValue = value; 
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private final int rgbValue; 
private final byte byteValue; 
) 
} 


需要 注意 的 是 ， 上 述 构造 方法 定义 设置 了 private 访问 权限 ， 其 原因 在 于 ， 此 处 并 不 
希望 该 构造 方法 在 Block 类 外 部 被 访问 。 由 于 其 他 类 仍然 需要 通过 某 种 方式 创建 图 块 实 
例 ， 因 而 须 对 此 定义 一 个 静态 方法 ， 即 createBlock 方法 ， 如 下 所 示 : 


public class Block { 
private int shapeIndex; 
private int frameNumber; 
private BlockColor color; 
private Point position; 


构造 方法 定义 如 下 所 示 : 


private Block(int shapeIndex, BlockColor blockColor) ( 
this.frameNumber - 0; 
this.shapeIndex - shapeIndex; 
</span> this.color = blockColor; 
this.position - new Point( FieldConstants.COLUMN COUNT 
.getValue()/2, 0); 


public static Block createBlock() ( 
Random random - new Random(); 
int shapeIndex = random.nextInt (Shape.values().length); 
BlockColor blockColor - BlockColor.values() 
[random.nextInt (BlockColor.values().length)]; 


Block block = new Block(shapeIndex, blockColor); 

block.position.x = block.position.x - Shape.values() 
[shapeIndex].getStartPosition(); 

return block; 


public enum BlockColor { 
PINK(Color.rgb(255, 105, 180), (byte) 2), 
GREEN(Color.rgb(0, 128, 0), (byte) 3), 
ORANGE(Color.rgb(255, 140, 0), (byte) 4), 
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YELLOW(Color.rgb(255, 255, 0), (byte) 5), 

CYAN(Color.rgb(0, 255, 255), (byte) 6); 

BlockColor(int rgbValue, byte value) ( 
this.rgbValue = rgbValue; 
this.byteValue - value; 

) 


private final int rgbValue; 
private final byte byteValue; 
} 
} 


createBlockO 随 机 选取 Shape 枚 举 类 中 图 块 形状 的 索引 以 及 BlockColor， 并 将 两 个 随 
机 选取 值 赋予 shapeIndex 和 blockColor 中 。 新 的 Block 实例 利用 这 两 个 值 〈 作 为 参数 被 
传递 ) 被 创建 ， 同 时 设置 了 X 轴 向 上 的 图 块 位 置 。 最 后 ，createBlock0 方 法 返回 经 创建 和 
初始 化 后 的 图 块 。 

这 里 ， 还 需要 向 Block 类 中 添加 相应 的 getter 和 setter， 用 以 访问 图 块 实例 中 较为 重 
要 的 属性 ， 对 应 方法 如 下 所 示 : 


public static int getColor(byte value) { 
for (BlockColor colour : BlockColor.values()) { 
if (value == colour.byteValue) ( 
return colour.rgbValue; 
) 
) 
return -1; 


} 


public final void setState(int frame, Point position) { 
this.frameNumber = frame; 
this.position = position; 


} 


@NonNull 
public final byte[][] getShape(int frameNumber) { 

return Shape. values () [shapeIndex] .getFrame (frameNumber) .as2dByteArray(); 
} 


public Point getPosition() { 
return this.position; 


} 
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public final int getFrameCount() { 
return Shape.values()[shapeIndex].getFrameCount () ; 


^ 


public int getFrameNumber() { 
return frameNumber; 


} 


public int getColor() { 
return color.rgbValue; 


} 


public byte getStaticValue() { 

return color.byteValue; 

} 

其 中 ，@NonNull 表示 为 Android 应 用 程序 框架 提供 的 注解 ， 并 以 此 说 明 某 个 字段 、 
参数 或 方法 返回 结果 不 可 为 null。 在 上 述 代码 片段 中 ，@NonNull 设置 于 getShape0 方 法 
之 前 ， 表 明 该 方法 不 可 返回 null 值 。 

0 «s. 

在 Java 中 ， 注 解 是 一 种 元 数据 形式 ， 并 可 添加 至 Java 源 代 码 中 。 另 外 ， 注 解 可 用 于 
类 、 方 法 、 变 量 、 参 数 和 数据 包 上 。 同 样 ， 注 解 也 可 在 Kotlin 中 声明 和 使 用 。 

@NotNull 注解 位 于 android.support.annotation 包 中 ， 在 Block.java 文件 中 ， 可 在 开始 
处 予以 导入 ， 如 下 所 示 : 

import android.support.annotation.NonNull; 

需要 注意 的 是 ， 在 Block 类 的 构造 方法 中 ， 当 前 图 块 实例 的 位 置 实例 变量 其 设置 方 
式 如 下 所 示 : 


this.position = new Point(FieldConstants.COLUMN COUNT.getValue()/2, 0); 


其 中 ， 图 块 生成 的 列 数 为 10， 这 一 常量 值 将 在 应 用 程序 代码 中 使 用 多 次 ， 因 而 可 将 
其 声明 为 常量 。 对 此 ， 可 在 应 用 程序 源 数据 包 中 创建 一 个 包 ， 并 将 名 为 FieldConstants 的 
Kotlin 文件 添加 至 该 数据 包 中 。 随 后 ， 可 添加 游戏 区 域 的 行 、 列 常量 。 当 前 ， 该 字段 包含 
了 10 列 、20 行 ， 如 下 所 示 : 

enum class FieldConstants(val value: Int) ( 


COLUMN COUNT(10), ROW COUNT (20); 
J; 
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接 下 来 ， 可 将 包含 FieldConstants 枚 举 类 的 数据 包 导 入 Block.java 中 ， 并 利用 常量 
COLUMN COUNT 蔡 换 整 数 10， 如 下 所 示 : 


this.position = new Point( FieldConstants.COLUMN COUNT.getValue()/2, 0); 
至 此 ，Block 类 的 编程 建 模 暂 告 一 段落 。 

3.1.2 ”构建 应 用 程序 模型 
前 述 内 容 讨论 了 构成 俄罗斯 方块 的 特定 组 件 的 建 模 过 程 ， 下 面 开始 着 手 定义 应 用 程 


序 逻 辑 ， 并 创建 应 用 程序 模型 以 实现 必要 的 俄罗斯 方块 游戏 的 逻辑 内 容 。 这 里 ， 程 序 逻 
辑 可 视 作 视图 和 图 块 组 件 之 间 的 中 间接 口 ， 如 图 3.7 所 示 。 


图 3.7 程序 逻辑 


其 中 ， 视 图 将 向 App 模型 发 送 动作 请 求 ， 相 应 地 ， 模 型 将 执行 该 动作 ， 并 向 视图 发 
送 反馈 信息 。 类 似 于 之 前 创建 的 模型 ， 此 处 也 需要 针对 App 模型 定义 一 个 独立 的 类 。 对 
此 ,可 创建 一 个 名 为 AppModelkt 的 Kotlin 文件 ， 并 向 该 文件 中 添加 AppModel 类 ， 同 时 
导入 Point、FieldConstants、array2dOfByte 和 AppPreferences， 如 下 所 示 : 


package com.mydomain.tetris.models 


import android.graphics.Point 

import com.mydomain.tetris.constants.FieldConstants 
import com.mydomain.tetris.helpers.array2dOfByte 
import com.mydomain.tetris.storage.AppPreferences 


class AppModel 


某 些 AppModel 函数 分 别 负 责 记录 当前 积分 值 、tetris 字段 状态 、 当 前 图 块 、 当 前 游 
戏 状 态 以 及 图 块 的 运行 行为 另外, AppModel 应 可 直接 访问 应 用 程序 的 SharedPreferences 
文件 中 存储 的 数值 ， 即 通过 所 定义 的 AppPreferences 类 。 初 看 之 下 ， 此 类 需求 较为 复杂 ; 
实际 上 ， 其 实现 过 程 十 分 简单 。 

首先 需要 添加 AppModel 所 使 用 的 一 些 常 量 ， 其 中 包括 游戏 体验 过 程 中 的 游戏 状态 ， 
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以 及 运动 行为 。 针 对 于 此 ， 可 使 用 下 列 枚 举 类 : 


class AppModel { 
enum class Statuses { 
AWAITING START, ACTIVE, INACTIVE, OVER 
} 


enum class Motions { 
LEFT, RIGHT, DOWN, ROTATE 
} 
} 


其 中 定义 了 4 个 状态 常量 。 具 体 来 讲 ，AWAITING START 表示 为 游戏 启动 之 前 的 
ARS: ACTIVE 表示 游戏 进程 中 的 状态 ，OVER 表示 为 游戏 结束 时 的 状态 。 

本 章 前 述 内 容 曾 讨论 到 ， 图 块 包含 了 4 个 独立 的 运动 状态 。 也 就 是 说 ， 图 块 可 实现 
右 移 、 左 移 、 上 移 和 下 移 。 对 此 , Motions 枚 举 类 中 分 别 定 义 了 LEFT、 RIGHT, UP. DOWN 
和 ROTATE， 以 表示 此 类 独特 的 运动 行为 。 

在 添加 了 所 需 的 常量 后 ， 即 可 加 入 相应 的 AppModel 类 属性 ， 如 下 所 示 : 


package com.mydomain.tetris.models 


import android.graphics.Point 

import com.mydomain.tetris.constants.FieldConstants 
import com.mydomain.tetris.helpers.array2dOfByte 
import com.mydomain.tetris.storage.AppPreferences 


class AppModel { 
var score: Int - 0 
private var preferences: AppPreferences? - null 


null 
Statuses.AWAITING START.name 


var currentBlock: Block? 
var currentState: String 


private var field: Array<ByteArray> = array2dOfByte( 
FieldConstants.ROW COUNT.value, 
FieldConstants.COLUMN COUNT.value 

) 


enum class Statuses ( 
AWAITING START, ACTIVE, INACTIVE, OVER 
} 
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enum class Motions { 
LEFT, RIGHT, DOWN, ROTATE 
} 
} 


score 表示 为 一 个 整数 属性 ， 用 于 加 载 游戏 会 话 过 程 中 玩家 的 当前 分 值 。Preferences 


定义 为 一 个 private 属性 , 加 载 AppPreferences 对 象 , 并 提供 了 应 用 程序 SharedPreferences 
文件 的 直接 访问 能 力 。 属 性 currentBlock 用 于 加 载 当前 图 块 的 平移 状态 。currentState 将 加 
载 游戏 状态 。Statuses.AWAITING START.name 将 以 AWAITING START 字符 串 形式 返 


回 


Statuses. AWAITING START 的 名 称 。 另 外 , 游戏 的 当前 状态 将 被 初始 化 为 AWAITING_ 


START， 其 原因 在 于 ， 这 将 是 GameActivity 启动 后 需要 转换 的 第 一 个 状态 。 最 后 ，field 
定义 为 一 个 二 维 数组 ， 并 用 作 游 戏 体验 区 域 。 


随后 ， 还 需要 添加 一 些 setter 和 getter 函数 ， 即 setPreferences(). setCellStatus() fll 


getCellStatus()， 并 将 其 加 入 AppModel 中 ， 如 下 所 示 : 


fun setPreferences (preferences: AppPreferences?) { 
this.preferences = preferences 


} 


fun getCellStatus(row: Int, column: Int): Byte? { 
return field[row] [column] 


} 


private fun setCellStatus(row: Int, column: Int, status: Byte?) { 
if (status != null) { 
field[row] [column] = status 
} 
} 


setPreferences() 方 法 将 AppModel 的 preferences 属性 设置 为 AppPreferences (作为 参 


数 传递 至 函数 中 ) 。getCellStatus0 方 法 返回 field 二 维 数组 中 特定 行 、 列 位 置 处 的 单元 格 
状态 。setCellStatus() 方 法 将 field 中 的 单元 格 状态 设置 为 特定 的 字 节 。 


同时 ， 模 型 中 还 需 定义 相应 的 状态 检测 函数 ， 并 以 此 确定 游戏 的 当前 状态 。 鉴 于 存 


在 的 3 种 游戏 状态 ， 因 而 须 针 对 每 种 状态 定义 共计 3 个 函数 ， 即 isGameAwaitingStart()、 
isGameActive()fll isGameOver0， 如 下 所 示 : 


class AppModel { 


var scores Tnt = 0 
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private var preferences: AppPreferences? = null 


var currentBlock: Block? = null 


var currentState: String Statuses.AWAITING START.name 


private var field: Array<ByteArray> = array2dOfByte( 
FieldConstants.ROW COUNT.value, 
FieldConstants.COLUMN COUNT.value 


fun setPreferences (preferences: AppPreferences?) { 
this.preferences - preferences 


fun getCellStatus(row: Int, column: Int): Byte? ( 
return field[row] [column] 


private fun setCellStatus(row: Int, column: Int, status: Byte?) { 
if (status != null) { 
field[row] [column] = status 


fun isGameOver(): Boolean { 
return currentState == Statuses.OVER.name 


fun isGameActive(): Boolean { 
return currentState == Statuses.ACTIVE.name 


fun isGameAwaitingStart(): Boolean { 
return currentState == Statuses.AWAITING START.name 


enum class Statuses { 
AWAITING START, ACTIVE, INACTIVE, OVER 


enum class Motions { 
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LEFT, RIGHT, DOWN, ROTATE 
} 
} 


取决 于 游戏 的 各 自 状 态 ， 上 述 3 个 方法 将 返回 相应 的 布尔 值 。 截 至 目前 ， 我 们 尚未 
使 用 到 AppModel 中 的 score。 下 面 将 定义 一 个 函数 ， 用 于 增加 score 所 持 有 的 分 值 ， 即 
boostScore0 函 数 ， 如 下 所 示 : 
private fun boostScore() { 
score += 10 
if (score > preferences?.getHighScore() as Int) 


preferences?.saveHighScore (score) 


) 

当 调 用 boostScore0 函 数 时 ， 该 函数 将 玩家 分 值 加 10， 并 于 随后 检测 当前 分 值 是 否 大 
于 预 置 文件 中 所 记录 的 最 高 分 值 。 若 是 ， 最 高 分 值 将 被 改写 为 当前 分 值 。 

在 介绍 了 上 述 较为 基本 的 函数 和 字段 之 后 ， 下 面 开始 讨论 一 些 较为 复杂 的 函数 。 其 
中 ， 第 一 个 函数 是 generateNextBlock0， 如 下 所 示 : 

private fun generateNextBlock() ( 


currentBlock - Block.createBlock() 


) 


generateNextBlockO 函 数 创建 新 的 图 块 实例 ， 同 时 将 currentBlock 设置 为 新 创建 的 实例 。 
在 进一步 讨论 方法 定义 之 前 ， 下 面 首先 创建 一 个 enum 类 ， 并 加 载 单元 格 的 常量 值 。 
对 此 ， 可 在 常量 数据 包 中 生成 CellConstants.kt 文件 ， 并 添加 下 列 源 代码 : 


package com.mydomain.tetris.constants 


enum class CellConstants(val value: Byte) { 
EMPTY (0), EPHEMERAL (1) 

} 

读者 可 能 会 对 这 一 类 常量 的 具体 含义 有 所 疑惑 。 回 忆 一 下 ， 当 创建 Frame 类 并 对 图 
块 进行 建 模 时 ， 曾 定义 了 addRow0 函 数 ， 并 接收 1 或 0 字符 串 作 为 参数 。 其 中 ，1 表示 
图 框 构 成 的 单元 格 ，0 表示 图 框 之 外 的 单元 格 ; 随后 ， 将 1 或 0 值 转换 为 字 节 表达 方式 。 
在 后 续 函 数 中 ， 将 会 操控 此 类 字 节 ， 并 对 其 定义 对 应 的 常量 值 。 

相应 地 ， 可 向 AppModel 中 导入 新 创建 的 enum 类 ， 并 在 接 下 来 的 函数 中 对 其 加 以 使 
用 ， 如 下 所 示 : 


private fun validTranslation(position: Point, shape: Array<ByteArray>) : 
Boolean ( 
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return if (position.y < 0 || position.x < 0) ( 
false 


一 


else if (position.y + shape.size > FieldConstants.ROW COUNT.value) ( 
false 


else if (position.x + shape[0].size > FieldConstants 
-COLUMN COUNT.value) { 
false 
else { 
for (i in 0 until shape.size) ( 
for (j in 0 until shape[i].size) { 
val y = position.y * i 
val x = position.x + j 


if (CellConstants.EMPTY.value !- shape[il[j] && 
CellConstants.EMPTY.value !- field[y][x]) { 
return false 


相应 地 ， 可 将 validTranslation() 方 法 添加 至 AppModel 中 。 顾 名 思 义 ， 该 函数 根据 条 
件 集 检测 游戏 区 域内 图 块 的 平移 运动 是 否 有 效 。 若 平移 行为 可 正常 工作 , 该 函数 返回 true, 
否则 返回 false。 其 中 ， 前 3 个 条 件 测 试 俄罗斯 方块 的 平移 位 置 是 否 有 效 ，else 代码 块 检 
测 俄罗斯 方块 行将 移 至 的 单元 格 是 否 为 空 。 若 不 为 空 ， 则 返回 false. 

对 于 validTranslation0 函 数 ， 需 要 定义 一 个 调用 函数 。 对 此 ， 可 声明 一 个 moveValid() 
方法 实现 这 一 操作 ， 并 将 其 添加 至 AppModel， 如 下 所 示 : 

private fun moveValid(position: Point, frameNumber: Int?): Boolean ( 

val shape: Array<ByteArray>? = currentBlock? 
.getShape(frameNumber as Int) 


return validTranslation(position, shape as Array<ByteArray>) 


) 

ImoveValid0 调 用 了 validTranslation0 检 测 玩家 所 执行 的 运动 行为 是 否 被 允许 。 若 是 ， 则 返 
El true, 否则 返回 false。 除 此 之 外 , 还 需要 定义 其 他 一 些 重 要 的 方法 , 其 中 包括 generateField0、 
resetField()、 persistCellData(). assessField(). translateBlock(). blockAdditionPossible() ~ 
shiftRows(). startGame(). restartGame(). endGame() UJ /& resetModel(). 

下 面 首先 讨论 generateField0， 并 将 下 列 代码 添加 至 AppModel. 
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fun generateField(action: String) { 
if (isGameActive()) { 
resetField() 
var frameNumber: Int? = currentBlock?.frameNumber 
val coordinate: Point? = Point() 
coordinate?.x = currentBlock?.position?.x 
coordinate?.y - currentBlock?.position?.y 


when (action) ( 
Motions.LEFT.name -> ( 
coordinate?.x = currentBlock?.position?.x?.minus (1) 
) 
Motions.RIGHT.name -> ( 
coordinate?.x = currentBlock?.position?.x?.plus(1) 
) 
Motions.DOWN.name -> ( 
coordinate?.y = currentBlock?.position?.y?.plus(1) 
) 
Motions.ROTATE.name -> ( 
frameNumber = frameNumber?.plus (1) 


if (frameNumber !- null) ( 
if (frameNumber »- currentBlock?.frameCount as Int) 
frameNumber - 0 


if (!moveValid(coordinate as Point, frameNumber)) { 
translateBlock(currentBlock?.position as Point, 
currentBlock?.frameNumber as Int) 

if (Motions.DOWN.name == action) { 

boostScore() 

persistCellData() 

assessField() 

generateNextBlock() 


if (!blockAdditionPossible()) { 
currentState = Statuses.OVER.name; 
currentBlock = null; 
resetField (false); 
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} 
} else { 
if (frameNumber != null) { 
translateBlock (coordinate, frameNumber) 
currentBlock?.setState (frameNumber, coordinate) 
} 
} 
} 
} 


generateField() 将 生成 区 域 的 刷新 结果 ， 并 由 作为 参数 传递 至 generateField0) 的 相关 动 
作 所 决定 。 
generateField0 被 调用 后 ， 首 先 检测 游戏 是 否 处 于 活动 状态 。 如 果 游 戏 处 于 活动 状态 ， 
将 获取 图 框 号 和 坐标 。 随 后 ， 所 请 求 的 动作 将 通过 when 表达 式 确定 。 一 旦 确定 了 所 请 求 
的 动作 后 ， 对 于 左 移 、 右 移 以 及 下 移动 作 ， 将 适当 调整 图 块 坐 标 。 当 请 求 旋转 运动 时 ， 
frameNumber 将 被 调整 为 相应 的 图 框 号 ， 以 显示 俄罗斯 方块 对 应 的 旋转 状态 。 
接 下 来 ，generateField0 方 法 通过 moveValid0 判 断 所 请 求 运行 是 否 为 有 效 运动 。 对 于 
无 效 运动 行为 ， 图 块 通过 translateBlock0) 方 法 在 游戏 区 域内 保持 当前 位 置 不 变 。 
generateField() 方 法 分 别 调用 了 resetField()、persistCellData() 和 assessField0) 方 法 ， 下 
面 将 其 添加 至 AppModel 中 。 
private fun resetField(ephemeralCellsOnly: Boolean = true) ( 
for (i in 0 until FieldConstants.ROW COUNT.value) ( 
(0 until FieldConstants.COLUMN COUNT.value) 
.filter ( !ephemeralCellsOnly || field[i] [it] == 
CellConstants.EPHEMERAL.value } 
.forEach { field[i] [it] = CellConstants.EMPTY.value } 


} 
} 


private fun persistCellData() { 
for (i in 0 until field.size) { 
for (j in 0 until field[i].size) { 
var status = getCellStatus(i, j) 


if (status == CellConstants.EPHEMERAL.value) { 
status = currentBlock?.staticValue 
setCellStatus(i, j, status) 

} 
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private fun assessField() ( 
for (i in 0 until field.size) { 
var emptyCells = 0; 


for (j in 0 until field[i].size) { 
val status - getCellStatus(i, j) 
val isEmpty - CellConstants.EMPTY.value -- status 
if (isEmpty) 
emptyCells++ 
} 
if (emptyCells == 0) 
shiftRows (i) 


} 


可 能 读者 已 经 意识 到 ， 这 里 并 未 实现 translateBlock(). F ifi 1% i 77 02: XE [8] 
blockAdditionPossible(), shiftRows(), startGame(), restartGame0 、endGame0O 和 resetModel() 
方法 添加 至 AppModel， 如 下 所 示 : 


private fun translateBlock(position: Point, frameNumber: Int) ( 
synchronized(field) ( 
val shape: Array<ByteArray>? = currentBlock?.getShape (frameNumber) 


if (shape !- null) ( 
for (i in shape.indices) ( 
for (j in 0 until shape[il.size) ( 
val y = position.y + i 
val x = position.x + j 


if (CellConstants.EMPTY.value != shape[i][j]) { 
field[y] [x] = shape[il[jl 


private fun blockAdditionPossible(): Boolean { 
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if (!moveValid(currentBlock?.position as Point, 
currentBlock?.frameNumber)) { 
return false 
) 


return true 


private fun shiftRows(nToRow: Int) ( 
if (nToRow » 0) ( 
for (j in nToRow - 1 downTo 0) ( 
for (m in 0 until field[jl.size) ( 
setCellStatus(j + 1, m, getCellStatus(j, m)) 
) 


for (j in 0 until field[0].size) { 
setCellStatus(0, j, CellConstants.EMPTY.value) 
) 


fun startGame() { 
if (!isGameActive()) ( 
currentState = Statuses.ACTIVE.name 
generateNextBlock() 
} 


fun restartGame() { 
resetModel () 
startGame () 


fun endGame() { 
score = 0 
currentState = AppModel.Statuses.OVER.name 


private fun resetModel() { 
resetField(false) 
currentState = Statuses.AWAITING START.name 
score = N 
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如 果 所 请 求 的 运动 为 下 移 ， 且 运动 处 于 无 效 状 态 ， 则 表明 图 块 已 经 到 达 游戏 区 域 底 
部 。 此 时 ， 玩 家 的 分 值 通过 boostScoreO 被 调整 ， 且 游戏 区 域 中 的 所 有 单元 格 通过 
persistCellData() 方 法 保持 其 状态 。 随 后 ，assessField() 方 法 将 被 调用 ， 并 逐 行 遍 历 游戏 
域 ， 并 检测 所 填充 行 中 的 所 有 单元 格 ， 如 下 所 示 : 

private fun assessField() { 


for (i in 0 until field.size) ( 
var emptyCells = 0; 


区 


for (j in 0 until field[i].size) { 
val status = getCellStatus(i, j) 
val isEmpty = CellConstants.EMPTY.value == status 


if (isEmpty) 
emptyCells++ 
} 


if (emptyCells == 0) 
shiftRows (i) 
} 
} 


当 一 行 中 的 全 部 单元 格 均 被 填充 ， 该 行将 被 消除 并 通过 shiftRow0。 在 游戏 区 域 计 算 
完毕 后 ， 新 图 块 将 通过 generateNextBlock() 方 法 生成 ， 如 下 所 示 : 
private fun generateNextBlock() ( 


currentBlock - Block.createBlock() 


} 


在 新 图 块 置 于 游戏 区 域 之 前 ，AppModel 须 确保 当前 游戏 区 域 未 被 填充 ， 同时， 图 块 
可 通过 blockAdditionPossible( 方 法 移 至 游戏 区 域内 ， 如 下 所 示 : 


private fun blockAdditionPossible(): Boolean ( 
if (!moveValid(currentBlock?.position as Point, 
currentBlock?.frameNumber)) { 
return false 


} 


return true 


} 


如 果 无 法 实现 图 块 的 添加 信息 ， 这 将 表明 ， 全 部 图 块 累积 于 游戏 区 域 的 上 方 ， 从 而 
导致 游戏 结束 。 最 终 ， 游 戏 的 当前 状态 将 被 设置 为 Statuses.OVER，currentBlock 被 设置 
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为 null， 同 时 清空 游戏 区 域 。 

另外 一 方面 ,如果 运动 行为 从 开始 即 为 有 效 ， 对 应 图 块 将 通过 translateBlockO 移 至 其 
新 坐标 处 ， 当 前 图 块 状态 将 被 设置 为 新 坐标 以 及 frameNumber。 

待 设置 完毕 后 ， 即 可 成 功 地 创建 应 用 程序 模型 ， 并 处 理 游戏 逻辑 。 下 面 将 构建 视图 
以 利用 AppModel。 


3.1.3 创建 TetrisView 


截至 目前 ， 前 述 内 容 已 经 实现 了 相关 类 ， 并 对 俄罗斯 方块 的 图 块 、 图 框 以 及 形状 建 
模 ; 除 此 之 外 ， 还 实现 了 AppModel 类 ， 以 整合 视图 以 及 编程 组 件 之 间 的 交互 行为 。 如 果 
缺少 此 类 视图 ， 那么 , 用 户 将 无 法 与 AppModel 进行 交互 。 若 用 户 缺 少 与 游戏 之 间 的 交流 
方式 ， 该 游戏 将 难以 称 之 为 一 部 完整 的 作品 。 本 节 将 实现 TetrisView， 即 玩家 体验 俄罗斯 
方块 游戏 的 用 户 界面 。 

接 下 来 ,可 创建 名 为 view 的 数据 包 , 并 将 TetrisView.kt 文件 加 入 其 中 。 考 虑 到 TestrisView 
表示 为 一 个 View， 因 而 需要 扩展 View 类 。 对 此 ， 可 将 下 列 代码 添加 至 TetrisView.kt 中 : 


package com.mydomain.tetris.views 


import android.content.Context 

import android.graphics.Canvas 

import android.graphics.Color 

import android.graphics.Paint 

import android.graphics.RectF 

import android.os.Handler 

import android.os.Message 

import android.util.AttributeSet 

import android.view.View 

import android.widget.Toast 

import com.mydomain.tetris.constants.CellConstants 
import com.mydomain.tetris.GameActivity 

import com.mydomain.tetris.constants.FieldConstants 
import com.mydomain.tetris.models.AppModel 

import com.mydomain.tetris.models.Block 


class TetrisView : View ( 
private val paint - Paint() 


private var lastMove: Long - 0 
private var model: AppModel? - null 
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private var activity: GameActivity? = null 

private val viewHandler = ViewHandler (this) 

private var cellSize: Dimension = Dimension(0, 0) 
private var frameOffset: Dimension - Dimension(0, 0) 


constructor(context: Context, attrs: AttributeSet) : 
super(context, attrs) 


constructor(context: Context, attrs: AttributeSet, defStyle: Int) : 
super(context, attrs, defStyle) 


companion object ( 
private val DELAY = 500 
private val BLOCK OFFSET - 2 
private val FRAME OFFSET BASE - 10 
) 
) 
TetrisView 类 扩展 了 View 类 , 应 用 程序 视图 元 素 均 需要 对 该 类 进行 扩展 。 由 于 View 
类 型 中 包含 了 一 个 初始 化 构造 方法 ， 因 而 对 于 TetrisView 需要 声明 两 个 次 级 构造 方法 ， 
进而 根据 调用 哪 一 个 次 级 构造 方法 初始 化 视图 类 的 相关 构造 方法 。 
paint 属性 表示 为 android.graphics.Paint 实例 。Paint 类 包含 了 与 绘制 文本 、 位 图 和 几 
何 形状 相关 的 样式 和 色彩 信息 。lastMove 用 于 记录 上 一 次 移动 的 时 间 (以 毫秒 计 )。Model 
实例 用 于 加 载 AppModel 实例 ， 该 实例 与 TetrisView 交互 并 控制 游戏 体验 。Activity 表示 
为 所 创建 的 GameActivity 类 实例 。cellSize 和 frameOffset 属性 分 别 表示 游戏 中 单元 格 的 
尺寸 以 及 图 框 偏 移 。 
Android 应 用 程序 框架 并 未 提供 ViewHandler 和 Dimension， 因 而 需要 手动 对 其 予以 
实现 。 
1. 实现 ViewHandler 
由 于 图 块 在 游戏 区 域 中 以 固定 的 时 间 间 隔 移动 ， 因 而 需要 某 种 方式 设置 一 个 线程 ， 
以 处 理 图 块 的 运动 ， 进 而 休眠 或 唤醒 该 线程 以 使 图 块 在 一 定 的 时 间 量 后 处 于 运动 状态 。 
一 种 方法 是 使 用 句柄 处 理 消息 延迟 请 求 , 并 在 延迟 后 继续 处 理 消息 。 根据 Android 文档 中 
的 描述 ， 句 柄 可 发 送 或 处 理 与 线程 MessageQueue 关联 的 Meaasge 对 象 。 也 就 是 说 ， 每 个 
句柄 实例 均 与 某 个 线程 和 该 线程 的 消息 队列 有 所 关联 。 
ViewHandler 则 是 须 针 对 TetrisView 实现 的 自 定义 句柄 ， 以 满足 视图 的 消息 发 送 和 处 理 
需求 。 由 于 ViewHandler 定义 为 Handler 的 子 类 ， 因 而 需要 扩展 Handler， 并 向 ViewHandler 
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类 中 加 入 必需 的 行为 。 
对 此 ， 可 作为 private 类 ， 向 TetrisView 中 添加 VieHandler 类 ， 如 下 所 示 : 


private class ViewHandler(private val owner: TetrisView) : Handler() ( 


override fun handleMessage (message: Message) { 
if (message.what == 0) ( 
if (owner.model != null) ( 
if (owner.model!!.isGameOver()) { 
owner .model?.endGame () 
Toast.makeText (owner.activity, "Game over", 
Toast.LENGTH LONG) .show(); 
} 
if (owner.model!!.isGameActive()) { 
owner .setGameCommandWithDelay (AppModel .Motions . DOWN) 
} 
} 
} 
} 


fun sleep(delay: Long) { 
this .removeMessages (0) 
sendMessageDelayed (obtainMessage(0), delay) 
} 
} 
作为 参数 ，ViewHandler 类 在 其 构造 方法 中 接收 一 个 TetrisView 实例 ， 并 覆 写 了 其 超 
类 中 的 handleMessage0 〇 函数 。handleMessage0O) 函 数 负责 检测 所 发 送 的 消息 内 容 。 其 中 ， 
what 定义 为 一 个 整数 值 ， 表 明 所 发 送 的 消息 。 如 果 what 等 于 0， 所 传递 的 TetrisView 的 
实例 GHAR) 则 包含 一 个 不 等 于 0 的 模型 ， 此 时 ， 将 对 游戏 状态 进行 检测 。 如 果 游戏 
结束 ， 则 调用 AppModel 的 endGame0 函 数 ， 并 弹出 消息 对 话 框 以 提示 玩家 游戏 处 于 结束 
状态 。 如 果 游 戏 处 于 活动 状态 ， 那 么 ， 将 触发 下 移 运 动 。 
sleep() 方 法 简单 地 移 除 之 前 所 发 送 的 消息 ， 并 发 送 包含 延迟 〈 由 delay 参数 指定 ) 的 
新 消息 。 
2. 实现 Dimension 


Dimension 仅 需 加 载 两 个 属性 ， 即 width 和 height。 因 此 ， 这 可 视 作 数据 类 型 的 最 佳 
候选 者 。 相 应 地 ， 可 将 下 列 private 类 添加 至 TetrisView 类 中 ， 如 下 所 示 : 


private data class Dimension(val width: Int, val height: Int) 
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其 中 包含 了 当前 属性 ， 以 及 所 需 的 setter 和 getter。 

3. 实现 TetrisView 

相信 读者 已 经 猜测 到 ， 当 前 ， 与 TetrisView 相关 的 工作 还 远 未 结束 。 首 先 ， 需 要 针 
对 视图 的 model 和 activity 属性 实现 相应 的 setter 和 getter, 并 将 其 添加 至 TetrisView 类 中 
如 下 所 示 : 


fun setModel (model: AppModel) { 
this.model = model 


} 


fun setActivity(gameActivity: GameActivity) { 
this.activity = gameActivity 


} 


setModel()fll setActivity) XN model 和 activity 属性 的 setter 函数 。 顾 名 思 义 ， 
setModel0 函 数 设置 视图 当前 所 使 用 的 模型 ，setActivity0 函 数 则 负责 设置 所 使 用 的 活动 。 下 
面 添 加 3 个 辅助 方法 , BI setGameCommand(). setGameCommandWithDelay()fll updateScore(), 
如 下 所 示 : 
fun setGameCommand (move: AppModel.Motions) { 
if (null != model && (model?.currentState == 
AppModel.Statuses.ACTIVE.name)) { 
if (AppModel.Motions.DOWN == move) { 
model?.generateField (move.name) 
invalidate () 
return 
} 
setGameCommandWithDelay (move) 
} 
} 


fun setGameCommandWithDelay(move: AppModel.Motions) { 
val now = System.currentTimeMillis () 


if (now - lastMove > DELAY) { 
model?.generateField (move.name) 
invalidate() 
lastMove - now 

} 

updateScores () 

viewHandler.sleep (DELAY.toLong() ) 
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private fun updateScores() ( 
activity?.tvCurrentScore?.text = "${model?.score}" 


activity?.tvHighScore?.text = 


"S{activity?.appPreferences?.getHighScore() }" 


} 


setGameCommand() 方 法 设置 游戏 所 执行 当前 运动 命令 。 如 果 DOWN 运动 命令 处 于 
执行 状态 ,应 用 程序 模型 将 生成 图 块 下 移 区 域 .在 setGameCommand0 中 调用 的 invalidated) 


方法 可 视 作 


一 个 请 求 ， 进 而 绘制 屏幕 上 的 变化 内 容 。 相 应 地 ，invalidate0 方 法 最 终 将 调用 


onDraw()J7 iX. « 

onDraw() 方 法 继承 于 View 类 ， 并 在 视图 泻 染 其 中 的 相关 内 容 时 被 调用 。 针 对 当前 视 
图 ， 应 对 此 提供 一 个 自 定义 实现 ， 并 将 其 添加 至 TetrisView 类 中 ， 如 下 所 示 : 

override fun onDraw(canvas: Canvas) { 


super.onDraw (canvas) 
drawFrame (canvas) 


if (model !- null) ( 
for (i in 0 until FieldConstants.ROW COUNT.value) { 
for (j in 0 until FieldConstants.COLUMN COUNT.value) ( 


} 


drawCell(canvas, i, j) 


private fun drawFrame(canvas: Canvas) { 
paint.color = Color. LTGRAY 


canvas.drawRect (frameOffset.width.toFloat(), 


frameOffset.height.toFloat(), width - 


frameOffset.width.toFloat(), 


height - frameOffset.height.toFloat(), paint) 


private fun drawCell(canvas: Canvas, row: Int, col: Int) ( 
val cellStatus = model?.getCellStatus (row, col) 


if (CellConstants.EMPTY.value != cellStatus) ( 
val color = if (CellConstants.EPHEMERAL.value == cellStatus) { 
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model?.currentBlock?.color 
) else { 

Block.getColor(cellStatus as Byte) 
) 


drawCell(canvas, col, row, color as Int) 


private fun drawCell(canvas: Canvas, x: Int, y: Int, rgbColor: Int) { 
paint.color - rgbColor 


val top: Float = (frameOffset.height + y * cellSize.height + 
BLOCK OFFSET) .toFloat () 

val left: Float = (frameOffset.width + x * cellSize.width + 
BLOCK OFFSET) .toFloat () 

val bottom: Float = (frameOffset.height + (y + 1) * cellSize.height - 
BLOCK_OFFSET) .toFloat () 

val right: Float = (frameOffset.width + (x + 1) * cellSize.width - 
BLOCK OFFSET) .toFloat () 

val rectangle = RectF (left, top, right, bottom) 


canvas.drawRoundRect (rectangle, 4F, 4F, paint) 


} 


override fun onSizeChanged (width: Int, height: Int, previousWidth: 
Int,previousHeight: Int) { 
super.onSizeChanged (width, height, previousWidth, previousHeight) 


val cellWidth = (width - 2 * FRAME OFFSET BASE) / 
FieldConstants.COLUMN COUNT.value 

val cellHeight = (height - 2 * FRAME OFFSET BASE) / 
FieldConstants.ROW COUNT.value 

val n = Math.min(cellWidth, cellHeight) 

this.cellSize = Dimension(n, n) 

val offsetX - (width - FieldConstants.COLUMN COUNT.value * n) / 2 

val offsetY (height - FieldConstants.ROW COUNT.value * n) / 2 

this.frameOffset = Dimension(offsetX, offsetY) 
) 


TetrisView 中 的 onDraw0 方 法 宪 写 了 其 超 类 中 的 onDraw0 方 法 。onDraw0 方 法 接收 
画布 (canvas) 对 象 作为 其 唯一 的 参数 ， 且 需要 在 其 超 类 中 调用 onDraw0 函 数 。 这 一 操 
作 是 通过 调用 super.onDraw0 完 成 的 ， 并 传递 画布 实例 作为 参数 。 


tl 
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在 调用 了 super.onDraw0O 后 ，TetrisView 中 的 onDraw0 将 调用 drawFrame0， 这 将 绘 
制 TetrisView 的 图 框 。 随 后 , 个 体 单元 格 将 在 画布 中 进行 绘制 , 即使 用 所 生成 的 drawCell0 

setGameCommandWithDelay0 的 工作 方式 类 似 于 setGameCommand0, 唯一 差别 在 于 ， 
前 者 更 新 游戏 的 积分 值 ， 并 在 执行 了 游戏 命令 后 ， 将 viewHandler 置 于 睡眠 状态 。 
updateScore0 函 数 用 于 更 新 游戏 活动 中 的 当前 积分 值 ， 以 及 最 高 分 值 的 文本 视图 。 

onSizeChanged0) 函 数 在 视图 尺寸 发 生变 化 时 被 调用 ,该 函数 可 访问 视图 的 当前 宽度 、 
高 度 ， 以 及 之 前 的 宽度 和 高 度 值 。 类 似 于 之 前 所 用 的 其 他 覆 写 函数 ， 这 里 同样 可 调用 超 
类 中 的 对 应 函数 。 相 应 地 ， 可 利用 宽度 和 高 度 参 数 计算 、 设 置 每 个 单元 格 的 尺寸 维度 ， 
即 cellSize。 最 后 ， 在 onSizeChanged0 方 法 中 ， 还 将 计算 offsetX 和 offsetY， 并 用 于 设置 
frameOffset。 


4. 完成 GameActivity 


至 此 ， 我 们 已 经 成 功 地 实现 了 视图 、 句 柄 、 帮 助 函数 、 类 以 及 模型 ， 并 可 将 其 整合 
至 俄罗斯 方块 游戏 中 。 上 有 具体 来 讲 ， 我 们 需要 将 相关 内 容 整 合 至 GameActivity 中 。 首 先 ， 
需要 将 新 创建 的 tetris 视图 添加 至 游戏 活动 布局 中 。 通 过 <com.mydomain .tetris.views. 
TetrisView> 布 局 标签 ， 可 方便 地 将 TetrisView 作为 子 元 素 添加 至 布局 文件 中 ， 如 下 所 示 : 


«?xml version-"1.0" encoding="utf-8"?> 
«android.support.constraint.ConstraintLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
xmlns:app-"http://schemas.android.com/apk/res-auto" 
xmlns:tools-"http://schemas.android.com/tools" 
android:layout width-"match parent" 
android:layout height-"match parent" 
tools:context-"com.mydomain.tetris.GameActivity"^ 
<LinearLayout 


android:layout width-"match parent" 
android:layout height-"match parent" 
android:orientation-"horizontal" 
android:weightSum-"10" 
android:background-"£e8e8e8"» 
<LinearLayout 
android: layout_width="wrap_ content" 
android:layout height="match parent" 
android: orientation="vertical" 
android: gravity="center" 
android: paddingTop="32dp" 
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android:paddingBottom-"32dp" 
android:layout weight="1"> 
<LinearLayout 
android: layout_width="wrap_ content" 
android: layout_height="0dp" 


android:layout weight="1" 
android:orientation="vertical" 
android:gravity="center"> 

<TextView 
android: layout_width="wrap_ content" 
android: layout_height="wrap_ content" 
android:text="@string/current_score" 
android:textAllCaps-"true" 
android:textStyle-"bold" 
android:textSize-"14sp"/» 

<TextView 
android:id="@+id/tv_current_score" 
android: layout_width="wrap content" 
android:layout height="wrap content" 
android: textSize="18sp"/> 

<TextView 
android: layout_width="wrap_ content" 
android:layout height-"wrap content" 
android:layout marginTop-"Gdimen/layout margin top" 
android:text="@string/high score" 
android:textAllCaps-"true" 
android:textStyle-"bold" 
android:textSize-"14sp"/» 

«TextView 
android: id="@+id/tv_high_score" 
android:layout width="wrap content" 
android:layout height-"wrap content" 
android:textSize-"18sp"/» 

</LinearLayout> 
<Button 
android: id="@+id/btn_restart" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text="@string/btn restart"/> 
</LinearLayout> 
<View 
android: layout_width="1dp" 
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android:layout height-"match parent" 
android:background-"$000"/» 
<LinearLayout 
android: layout_width="0dp" 
android: layout_height="match parent" 
android:layout weight="9"> 
<!-- Adding TetrisView --> 
<com.mydomain.tetris.views.TetrisView 
android: id="@+id/view tetris" 
android:layout width-"match parent" 
android:layout height-"match parent" /» 


</LinearLayout> 
</LinearLayout> 
</android.support.constraint.ConstraintLayout> 


一 旦 将 tetris 视图 添加 至 activity_game.xml， 即 可 打开 GameActivity 类 ， 并 添加 下 列 
代码 : 


package com.mydomain.tetris 


import android.os.Bundle 

import android.support.v7.app.AppCompatActivity 
import android.view.MotionEvent 

import android.view.View 

import android.widget.Button 

import android.widget.TextView 

import com.mydomain.tetris.models.AppModel 

import com.mydomain.tetris.storage.AppPreferences 
import com.mydomain.tetris.views.TetrisView 


class GameActivity: AppCompatActivity() ( 


var tvHighScore: TextView? = null 
var tvCurrentScore: TextView? = null 
private lateinit var tetrisView: TetrisView 


var appPreferences: AppPreferences? = null 
private val appModel: AppModel = AppModel () 


public override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate (savedInstanceState) 
setContentView(R.layout.activity game) 
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appPreferences = AppPreferences (this) 
appModel.setPreferences (appPreferences) 


val btnRestart = findViewById<Button>(R.id.btn restart) 
tvHighScore = findViewById«TextView» (R.id.tv high score) 
tvCurrentScore = findViewById«TextView» (R.id.tv current score) 


tetrisView = findViewById<TetrisView>(R.id.view tetris) 
tetrisView.setActivity (this) 
tetrisView.setModel (appModel) 


tetrisView.setOnTouchListener (this::onTetrisViewTouch) 
btnRestart.setOnClickListener(this::btnRestartClick) 


updateHighScore() 
updateCurrentScore() 


private fun btnRestartClick(view: View) { 
appModel. restartGame () 
} 


private fun onTetrisViewTouch (view: View, event: MotionEvent) : 
Boolean { 
if (appModel.isGameOver() || appModel.isGameAwaitingStart()) { 
appModel.startGame () 
tetrisView. setGameCommandWithDelay (AppModel .Motions. DOWN) 


} else if (appModel.isGameActive()) { 
when (resolveTouchDirection(view, event)) { 
0 -> moveTetromino (AppModel .Motions.LEFT) 
1 -> moveTetromino (AppModel .Motions. ROTATE) 
2 -> moveTetromino (AppModel .Motions. DOWN) 
3 -» moveTetromino (AppModel.Motions.RIGHT) 


} 


return true 


private fun resolveTouchDirection(view: View, event: MotionEvent) : 
int f 
val x = event.x / view.width 
val y = event.y / view.height 
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val direction: Int 


direction = if (y > x) ( 
if (x > 1 - y) 2 else 0 
} 
else { 
ang (E il ew SEIL 
) 
return direction 


} 


private fun moveTetromino(motion: AppModel.Motions) { 
if (appModel.isGameActive()) { 
tetrisView.setGameCommand (motion) 
} 
} 


private fun updateHighScore() { 
tvHighScore?.text = "${appPreferences?.getHighScore() }" 
} 


private fun updateCurrentScore() { 
tvCurrentScore?.text = "0" 
} 

} 

上 述 代码 以 tetrisView 属性 的 形式 ， 向 activity game.xml 中 的 tetris 视图 布局 元 素 添 
加 了 一 个 对 象 引 用 。 除 此 之 外 ， 还 创建 了 AppModel 实例 ， 并 通过 GameActivity 加 以 使 
用 。 在 oncreate(0 方 法 中 , 我们 将 tetrisView 使 用 的 活动 设置 为 GameActivity 的 当前 实例 ， 
并 将 tetrisView 使 用 的 模型 设置 为 appModel 一 一 即 所 创建 的 AppModel 实例 属性 。 除 此 之 
外 ，tetrisView 的 触摸 监听 器 设置 为 onTetrisViewTouchQ FR Zi « 

如 果 单 击 〈 触 摸 )》 了 tetrisView， 且 游戏 位 于 AWAITING START 或 OVER 状态 ， 
则 启动 一 个 新 游戏 。 如 果 单 击 ( 触 摸 ) 了 tetrisView， 且 游戏 处 于 ACTIVE 状态 ,在 
resolveTouchDirection() 的 帮助 下 ,可 解决 tetrisView 上 触摸 产生 的 方向 。 moveTetromino() 
根据 传递 于 其 中 的 相关 动作 移动 俄罗斯 方块 。 如 果 出 现 左 向 触摸 ， 则 通过 作为 参数 传递 
的 AppModel.Motions.LEFT 调用 moveTetromino0， 这 将 在 游戏 区 域内 向 左 移动 俄罗斯 方 
块 。tetrisView 的 右 、 下 、 上 方向 上 的 触摸 则 导致 右 向 、 下 向 以 及 旋转 运动 。 

随后 ， 可 构建 并 运行 当前 项 目 。 一 旦 项 目 在 设备 上 启动 ， 可 导航 至 游戏 活动 ， 并 触 
摸 屏幕 右边 的 俄罗斯 方块 视图 。 游 戏 的 启动 状态 如 图 3.8 所 示 。 
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图 3.8 游戏 的 启动 状态 


32 MVP 模式 简介 


在 Tetris 应 用 程序 开发 过 程 中 , 我 们 曾 尝试 在 代码 库 中 添加 结构 , 根据 执行 的 任务 将 
程序 文件 分 离 到 不 同 的 包 中 。 此 外 , 还 将 应 用 程序 逻辑 抽象 至 AppModel 类 中 ,与 游戏 相 
关 的 用 户 交互 将 由 TetrisView 视图 类 处 理 。 据 此 ， 代 码 库 体现 了 某 种 秩序 ， 而 不 是 将 所 
有 的 逻辑 放 入 一 个 较 大 的 类 文件 中 。 

在 Android 应 用 程序 中 存在 更 好 的 方法 来 分 离 所 关注 的 内 容 ，MVP 模式 便 是 其 中 之 一 。 


3.2.1 MVP 的 含义 


MVP 是 Android 中 的 一 种 常见 模式 ， 并 源 自 模型 -视图 -控制 器 模式 。MVP 试图 从 应 
用 程序 逻辑 中 查看 相关 的 关注 内 容 。MVP 模式 的 优点 主要 体现 在 以 下 几 方面 : 
Cl “增加 代码 库 的 可 维护 性 。 
O ”改善 应 用 程序 的 可 读 性 。 
MVP 模式 如 图 3.9 所 示 。 
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图 3.9 MVP 模式 

下 面 考察 MVP 模式 中 的 各 项 内 容 。 
1. 模型 
在 MVP 模式 中 ， 模 型 表示 为 持 有 数据 管理 任务 的 接口 ， 其 责任 包括 与 数据 库 交 互 、 
执行 API 调用 、 网 络 通 信 ， 以 及 协同 对 象 和 其 他 编程 执行 特定 任务 。 

2. 视图 

视图 表示 为 应 用 程序 实体 ， 用 于 向 用 户 显 示 相 关内 容 ， 并 视 作 用 户 输入 的 界面 。 视 
图 可 以 是 一 个 活动 、 片 段 或 者 是 Android 微 件 。 视 图 通过 显示 机 制 泻 染 数据 。 

3. 显示 

显示 机 制 饰 演 了 视图 和 模型 的 中 间 组 件 ， 主 要 负责 查询 模型 并 更 新 视图 。 简 单 地 讲 ， 
显示 机 制 中 包含 了 相关 显示 逻辑 ， 且 与 视图 间 包 含 一 一 对 应 的 关系 。 


3.2.2 MVP 实现 


在 实际 操作 过 程 中 ，MVP 模式 实现 方式 也 有 所 变化 。 例 如 ， 一 些 MVP 实现 采用 了 
合约 描述 视图 和 显示 之 间 的 接口 。 

除 此 之 外 , HEHE MVP 实现 还 采用 了 显示 机 制 中 的 生命 周期 回调 方法 , 例如 onCreateQ) 
方法 。 这 试图 镜像 存在 于 活动 生命 周期 内 的 回调 。 其 他 一 些 实现 方案 则 完全 启用 了 这 一 
类 回调 方法 。 

实际 上 ， 在 Android 应 用 程序 中 并 没有 真正 实现 MVP， 但 是 在 实现 MVP 的 过 程 中 
可 以 遵循 一 些 最 佳 实践 方案 。 第 5 章 将 对 此 加 以 深入 讨论 。 
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本 章 实 现 了 经 典 的 俄罗斯 方块 游戏 ， 其 中 涉及 了 较 多 内 容 。 例 如 ， 如 何 利用 类 对 应 
用 程序 的 逻辑 组 件 建 模 、 访问 操作 和 可 见 性 修饰 符 , 如 何 创建 Android 应 用 程序 中 的 视图 
和 句柄、 数据 类 的 访问 (以 方便 地 创建 数据 模型 》， 以 及 MVP 模式 。 

第 4 章 将 考察 Kotlin 语言 在 Web 方面 的 应 用 ， 并 实现 通信 应 用 程序 的 后 端 内 容 。 
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在 前 述 章 节 中 ， 通 过 经 典 的 俄罗斯 方块 游戏 ， 讨 论 了 Kotlin 程序 设计 语言 的 一 些 基 
本 知识 。 第 3 章 实现 了 该 游戏 的 应 用 程序 逻辑 ， 并 针对 图 块 、 形 状 、 图 框 以 及 应 用 程序 
构建 了 相应 的 模型 。 除 此 之 外 ,我 们 还 通过 Tetris 视图 创建 了 自 定义 视图 ， 即 应 用 程序 用 
户 与 游戏 体验 之 间 的 视图 。 

本 章 将 进一步 讨论 Kotlin 应 用 程序 开发 技巧 ， 即 实现 一 款 基于 Android 平台 的 通信 
应 用 程序 。 其 间 ， 首 先 将 介绍 RESTful API 开发 ， 进 而 向 后 台 应 用 程序 提供 Web 内 容 。 
该 应 用 程序 编程 接口 将 采用 Spring Boot 2.0 构建 。 在 应 用 程序 保持 接口 开发 完毕 后 ， 会 
将 其 部 署 至 远程 服务 器 上 。 本 章 主要 涉及 以 下 内 容 : 
口 基本 的 系统 设计 方案 。 
QO 利用 状态 示意 图 对 系统 行为 建 模 。 
Q ”数据库 设 计 基 础 知识 。 
O 利用 实体 关系 (E-R) 示 意图 对 数据 库 建 模 。 
口 利用 Spring Boot 2.0 构建 后 台 微 服务 。 
口 与 PostgreSQL 协同 工作 。 
口 
口 
下 


利用 Maven 实现 依赖 关系 管理 。 
亚马逊 Web 服务 CAWS) 。 
面 首先 讨论 Messenger 应 用 程序 编程 接口 。 


4.1 设计 Messenger API 


对 于 MessengerAndroid 应 用 程序 ， 当 设计 全 功能 的 RESTful 编程 接口 时 ， 需 要 理解 
应 用 程序 编程 接口 、 表 述 性 状态 转移 (REST) 以 及 RESTful 服务 。 


4.1.1 应 用 程序 编程 接口 
应 用 程序 编程 接口 表示 为 函数 、 例 程 、 程 序 、 协 议 以 及 资源 的 集合 ， 并 用 以 构建 软 


件 。 换 言 之 ， 应 用 程序 编程 接口 (简称 APD 表示 为 设计 良好 的 结构 化 方法 ， 或 者 是 软 
件 组 件 之 间 的 通信 渠道 。 
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应 用 程序 编程 接口 的 开发 涉及 较 多 的 领域 ， 例 如 Web 系统 开发 、 操 作 系统 、 计 算 机 
硬件 ， 以 及 嵌入 式 系统 的 交互 。 


4.1.2 REST 


Restful 状态 传输 是 一 种 通过 互联 网 促进 两 个 或 多 个 不 同系 统 〈 或 子 系统 ) 之 间 的 功 
能 操作 和 交互 的 方法 。 基 于 REST 的 Web 服务 使 得 交互 系统 可 访问 Web AA; 同时 ,还 
将 针对 所 访问 的 Web 内 容 执行 授权 操作 。 这 些 系统 间 通 信和 是 使 用 一 组 定义 良好 的 无 状态 
操作 来 完成 的 。RESTful Web 基于 REST， 并 通过 预定 义 的 无 状态 操作 向 通信 系统 提供 
Web 内 容 。 

今 ， 许 多 与 Web 服务 通信 的 系统 都 使 用 了 REST。 基 于 REST 的 系统 均 采 用 了 客 
户 机 -服务 器 架构 。 我 们 将 要 开发 的 API 是 基于 REST 的 ， 因 此 将 使 用 到 表征 状态 转移 。 


lk 


4.1.3 设计 Messenger API 系统 


本 节 将 简要 介绍 Messenger API 系统 。 当 前 , 读者 可 能 尚 不 了 解 系统 设计 的 真实 含义 
及 其 相关 职责 ， 稍 后 将 对 此 了 予以 详细 介绍 。 

系统 设计 是 指定 义 体 系 结构 、 模 块 、 接 口 以 及 系统 的 数据 ， 以 满足 前 期 系统 分 析 阶 
段 提 出 的 各 项 要 求 。 系 统 设 计 包含 多 个 处 理 流程 以 及 不 同 的 设计 定位 。 除 此 之 外 ， 系 统 
的 深度 设计 还 将 涉及 多 个 话题 ， 例 如 耦合 和 聚合 ， 这 一 类 内 容 则 超出 了 本 书 的 讨论 范围 。 
针对 于 此 ， 下 面 将 对 系统 的 交互 行为 和 应 用 数据 给 出 基本 的 定义 ， 并 采用 渐进 式 系统 设 
计 方 案 。 

1. 增 量 式 开发 

增 量 式 开发 常 出 现 于 系统 开发 过 程 中 ， 并 采用 了 递增 的 构建 模块 。 这 里 ， 递 增 构建 
模块 是 一 种 软件 开发 方法 ， 其 中 ， 产 品 采 用 渐进 方式 设计 、 实 现 和 测试 。 本 章 中 的 
Messenger API 即 采用 了 增 量 式 开 发 方案 。 下 面 将 逐步 开发 Messenger API。 在 开始 编码 
之 前 ， 我 们 并 不 会 尝试 指定 Messenger API 所 需 的 全 部 内 容 。 相 应 地 ， 将 确定 一 组 规范 ， 
并 持续 进行 开发 ， 然 后 再 添加 某 些 功能 ， 随 后 将 重复 这 一 过 程 。 

为 了 轻松 地 使 用 增 量 开 发 方法 ， 须 通过 相关 软件 以 避免 开发 过 程 中 内 容 更 改 所 导致 
的 负面 影响 ， 例 如 需要 更 改 系统 所 提供 的 数据 类 型 。Spring Boot 是 增 量 开 发 系统 的 完美 
候选 者 ， 因 为 它 支持 对 系统 进行 快速 和 简单 的 更 改 。 

到 目前 为 止 ， 我 们 已 经 多 次 提 到 Spring Boot， 但 并 未 言及 其 内 容 和 用 途 ， 下 面 将 对 
此 予以 简要 介绍 。 
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2. Spring Boot 


Spring Boot 是 一 个 Web 应 用 程序 框架 , 主要 是 针对 Spring 应 用 程序 的 引导 指令 和 开 
发 而 设计 的 。Spring 是 一 个 Web 应 用 程序 框架 ， 并 为 Java 平台 开发 Web 应 用 程序 提供 
了 便利 。 另 外 ，Spring Boot 大 大 降低 了 工业 强度 产品 级 Spring 应 用 的 开发 难度 。 

本 章 将 探讨 如 何 使 用 Spring Boot 创建 Web 应 用 程序 。 在 开始 开发 应 用 程序 之 前 ， 
需要 首先 指定 应 用 程序 的 实际 功能 (毕竟 ， 在 不 了 解 其 工作 方式 之 前 ， 尚 无 法 构建 具体 
内 容 ) 。 

3. Messenger 系统 的 任务 


下 面 将 确定 Messenger 系统 的 初始 需求 条 件 ， 以 及 系统 中 可 能 出 现 的 活动 。 此 外 , 还 
将 考察 Messenger 应 用 程序 中 的 高 级 用 例 。 

(1) 用 例 

用 例 描述 了 实体 与 系统 之 间 的 应 用 方式 。 这 里 ， 实 体 表 示 为 与 系统 交互 的 用 户 或 组 
件 的 类 型 。 在 用 例 定义 中 ， 实 体 也 称 为 参与 者 (actor) 。 

下 面 尝试 定义 Messenger 系统 中 的 参与 者 。 显 然 , 应 用 程序 用 户 可 视 为 参与 者 (使 用 
应 用 程序 满足 其 消息 机 制 的 用 户 ) 。 另 一 个 参与 者 则 是 管理 员 。 不 过 ， 针 对 当前 简单 的 
Messenger 应 用 程序 ， 此 处 仅 考察 单一 用 户 参 与 者 。 用 户 的 用 例 包 括 以 下 内 容 : 

O HAF tA] Messenger 平台 发 送 、 接 收 消息 。 

Q MEH Messenger 平台 查看 Messenger 应 用 程序 中 的 其 他 用 户 。 

Q JAF (HAA Messenger 平台 设置 、 更 新 其 状态 。 

Q “用户 可 注册 Messenger 平台 。 

O METE Messenger 平台 。 

如 果 在 系统 开发 过 程 中 遇 到 了 一 个 新 的 用 例 ， 那 么 ， 应 可 很 方便 地 将 其 添加 到 系统 
中 。 在 确定 了 系统 的 用 例 后 ， 还 需要 恰当 地 描述 系统 在 满足 这 些 用 例 时 的 行为 。 

(2) 系统 行为 

系统 行为 的 定义 旨 在 更 加 准确 地 描述 系统 执行 的 任务 ， 以 及 清晰 地 展示 系统 组 件 之 
间 的 交互 行为 。 考 虑 到 当前 应 用 程序 较为 简单 ， 因 而 可 借助 示意 图 清楚 地 描述 应 用 程序 
的 行为 。 对 此 ， 可 利用 状态 图 对 此 了 予以 描述 。 

状态 图 用 于 描述 系统 的 行为 ， 也 就 是 说 ， 描 述 基于 不 同 状 态 的 系统 。 在 状态 图 中 ， 
系统 中 包含 了 有 限 数 量 的 状态 。 
图 4.1 显示 了 当前 系统 中 的 状态 图 ， 其 中 包含 了 所 定义 的 多 个 用 例 。 

示意 图 中 的 每 个 圆圈 代表 某 一 时 刻 系统 的 执行 状态 。 另 外 ， 每 个 箭头 表示 为 用 户 请 
求 的 动作 ， 并 由 系统 予以 执行 。 在 初始 状态 ，API 等 待 来 自 客户 端 应 用 程序 的 请 求 ， 该 
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行为 在 图 中 显示 为 “等 待 动作 ”状态 。 当 动作 请 求 被 源 自 客户 端 应 用 程序 的 API 接收 后 ， 
系统 退出 “等 待 动作 ”状态 和 服务 ， 请 求 通过 适当 的 进程 发 送 。 


传递 处 理 过 程 
向 用 户 传递 请 求 响应 


注册 请 求 视图 用 户 


开启 后 的 sp? 


传递 状态 更 新 反馈 
发 送 用 户 列表 


登录 请 求 


说 处 理 响 上 
请 求 状态 更 新 传递 处 理 响 应 


图 4.1 当前 系统 中 的 状态 图 


例如 ， 当 用 户 从 Android 应 用 程序 中 请 求 状 态 更 新 时 ， 服 务 器 将 退出 “等 待 动作 ” 状 
态 并 执行 “状态 更 新 ”过 程 ， 然 后 返回 “等 待 动作 ”状态 。 

(3) 识别 数据 

需要 注意 的 是 ， 在 实现 系统 之 前 ， 应 了 解 所 需 的 数据 类 型 。 对 此 ， 可 以 很 容易 地 从 
前 面 给 出 的 用 例 定义 中 识别 这 些 数据 。 基 于 当前 用 例 规范 ， 可 以 确定 需要 两 种 基本 类 型 
的 数据 ， 即 用 户 数据 和 消息 数据 。 顾 名 思 义 ， 用 户 数据 是 每 个 用 户 所 需 的 数据 ;消息 数 
据 则 是 与 发 送 的 消息 相关 的 数据 。 当 前 ， 可 和 暂 不 考虑 模式 、 实 体 或 实体 关系 图 等 内 容 ， 
只 需 对 系统 所 需 的 数据 有 一 个 大 致 的 概念 。 

对 于 Messenger 应 用 ， 用户 需要 使 用 到 用 户 名 、 电 话 号 码 、 密 码 和 状态 信息 。 除 此 之 
外 ， 还 有 必要 跟踪 账户 的 状态 ， 以 了 解 某 个 特定 用 户 的 账户 是 否 被 激活 ， 或 由 于 某 种 原 
因 被 停 用 。 当 前 ， 暂 不 需要 对 所 发 送 的 消息 予以 太 多 关注 ， 我 们 需要 跟踪 消息 的 发 送 方 
和 消息 的 预期 接收 者 。 
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关于 所 需 数据 ， 相 关内 容 大 致 如 此 。 随 着 开发 过 程 的 不 断 深 入 ， 还 将 识别 更 多 的 所 
需 数据 。 下 面 讨论 具体 的 编码 过 程 。 
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前 述 内 容 整体 探讨 了 Messenger 系统 的 用 例 、 系 统 所 需 的 数据 和 系统 的 行为 , 本 节 将 
着 手 开 发 系统 的 后 端 。 如 前 所 述 , 作为 增 量 式 开发 的 最 佳 候选 者 , 我 们 将 使 用 Spring Boot 
开发 messenger API。 除 此 之 外 ，Kotlin 和 Spring Boot 功能 之 间 也 实现 了 较 好 的 整合 。 

考虑 到 将 在 Messenger API 中 处 理 数 据 ， 因 而 需要 一 种 较为 适宜 的 数据 库 ， 以 存储 
Messenge 系统 所 需 的 数据 。 对 此 ， 我 们 将 使 用 PostgreSQL 数据 库 。 下 面 对 PostgreSQL 
做 一 个 简要 的 介绍 。 


4.2.1 PostgreSQL 


PostgreSQL 是 一 个 对 象 关系 数据 库 管 理 系统 ， 特 别 强 调 可 扩展 性 和 标准 的 遵从 性 。 
PostgreSQL 也 称 为 Postgres, 通常 被 用 作 数 据 库 服务 器 。 当 以 这 种 方式 使 用 时 ,其 主要 功 
能 是 安全 地 存储 数据 并 返回 软件 应 用 程序 请 求 存储 的 数据 。 

作为 一 种 数据 库 ，PostgreSQL 拥有 诸多 优点 ， 其 中 包括 : 

口 可 扩展 性 。PostgreSQL 特性 可 方便 、 可 靠 地 由 其 用 户 进行 扩展 一 一 对 应 的 源 代 

码 免费 向 用 户 提供 。 
Q 可 移植 性 。PostgreSQL 适用 于 全 部 主流 平台 。 几 乎 每 个 UNIX 版 本 都 可 以 使 用 
PostgreSQL. 44h, Windows 兼容 性 也 可 以 通过 Cygwin 框架 实现 。 

D 完整 性 。 包 含 了 许多 GUI 工具 ， 并 可 方便 地 与 PostgreSQL 进行 交互 。 

PostgreSQL 在 各 种 平台 上 的 安装 过 程 也 较为 简单 ， 本 节 主 要 讨论 Windows. macOS 
和 Linux 环境 下 的 安装 过 程 。 

1. Windows 环境 下 安装 

当 在 Windows 环境 下 安装 PostgreSQL 时 ， 须 执行 以 下 步 又: 

(1) 读者 可 访问 https://www.enterprisedb.com/downloads/postgres-postgresql- 
downloads#windows， 下 载 并 运行 适当 版 本 的 Windows PostgreSQL 安装 程序 。 

(2) 将 PostgreSQL 安装 为 Windows 服务 ， 并 确保 持 有 PostgreSQL Windows 服务 账 
户 和 密码 。 在 后 续 安 装 过 程 中 ， 将 会 使 用 到 这 些 细节 信息 。 

(3) 当 安 装 程序 显示 提示 信息 时 ， 选 择 PL/pgsql 过 程式 语言 。 
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(4) 在 Installation options 窗口 中 ， 可 选择 安装 pgAdmin。 如 果 安 装 了 pgAdmin, “4 
在 安装 程序 显示 提示 信息 时 ， 应 启用 Adminpack 构建 软件 捐赠 (contrib) 模块 。 
在 执行 了 上 述 各 步骤 后 ，PostgreSQL 将 被 安装 至 用 户 的 系统 中 。 
2. macOS 安装 


利用 Homebrew, PostgreSQL 可 方便 地 安装 在 macOS 上 。 如 果 系 统 上 尚未 安装 
Homebrew， 读 者 可 参考 第 1 章 中 的 相关 内 容 。 若 系统 中 已 经 安装 了 Homebrew， 则 可 打 
开 终 端 ， 并 运行 下 列 命令 : 
brew search postgres 
当 终 端 内 显示 提示 信息 时 ， 只 需 遵 循 相关 安装 指令 即 可 。 在 安装 过 程 中 ， 可 能 会 ? 
询问 管理 员 密码 ， 读 者 可 输入 对 应 的 密码 ， 并 等 待 安装 结束 。 
3. Linux 安装 
通过 PostgreSQL Linux 安装 程序 ，PostgreSQL 可 方便 地 安装 于 Linux 环境 下 ， 相 关 
步骤 如 下 : 
(1) 访问 PostgreSQL 安装 程序 下 载 页 面 ， 对 应 网 址 为 https://www.enterprisedb.com/ 
downloads/postgres-postgresqldownloads. 
(2) 选择 希望 安装 的 PostgreSQL 版 本 。 
(3) 针对 PostgreSQL 选择 相应 的 Linux 安装 程序 。 
(4) 单 击 下 载 按钮 并 下 载 安装 程序 。 
(5) 下 载 完 毕 后 运行 安装 程序 ， 并 遵循 其 间 的 安装 指令 。 
(6) 在 提供 了 安装 程序 所 需 的 信息 后 ，PostgreSQL 即 在 系统 中 安装 完毕 。 
当 PostgreSQL 在 系统 中 设置 完毕 后 ， 即 可 开始 着 手 创建 Messenger API. 


4.2.2 创建 新 的 Spring Boot 应 用 程序 


通过 IntelliJ IDE 和 Spring 初始 化 器 , 很 容易 创建 Spring Boot 应 用 程序 。 打开 IntelliJ 
IDE， 并 利用 Spring Initializer 创建 新 的 项 目 。 对 此 ， 可 单 击 Create New Project， 并 选择 
New Project 屏幕 左 侧 操作 栏 的 Spring Initializer， 如 图 4.2 所 示 。 

在 选择 了 Spring Initializer 之 后 , 单 击 Next 按钮 。 随 后 , 在 显示 下 一 个 窗口 之 前 , IDE 
将 检索 Spring 初始 化 器 ， 这 需要 占用 几 分 钟 的 时 间 。 


0 注意 


Spring 插件 只 能 在 IntelliJ IDEA 的 最 终 版 本 中 使 用 ， 并 附带 付费 订阅 。 
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图 4.2 创建 Spring Boot 应 用 程序 


一 旦 检索 到 Spring Initializer， 用 户 将 被 询问 提供 某 些 项目 细 节 信 息 。 在 填写 完毕 后 ， 
读者 即 可 开发 本 书 中 的 应 用 程序 ， 或 者 ， 读 者 也 可 提供 自己 的 相关 信息 。 在 此 之 前 ， 读 
者 还 需 执行 以 下 各 项 步骤 : 

(1) 输入 com.example 作为 组 ID。 

(2) 输入 messenger-api 作为 工作 ID。 

(3) 选择 Maven Project 作为 项 目 类 型 。 

(4) 保留 包机 制 选项 以 及 Java 版 本 。 

(5) 选择 Kotlin 作为 当前 语言 ， 这 一 项 十 分 重要 ， 后 续 程 序 将 在 Kotlin 语言 的 基础 
上 进行 开发 。 

(6) 保持 SNAPSHOT 值 不 变 。 

C7) 输入 选择 描述 。 
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(8) 输入 com.example.messenger.api 作为 包 名 。 
在 填写 完 所 需 的 项 目 信息 后 ， 单 击 Next 按钮 ， 随 后 将 显示 如 图 43 所 示 的 窗口 。 


LJ e New Project 


图 4.3 新 项 目 窗口 


在 图 4.4 所 示 窗 口中 ， 用 户 将 被 询问 选择 项 目 依赖 关系 。 对 于 初学 者 来 说 ， 可 选择 
Security、Web、JPA 和 PostgreSQL 依赖 关系 。 其 中 ，Security 位 于 Core 分 类 下 ; Web 位 
于 Web 分 类 下 ; JPA 和 PostgreSQL 则 位 于 SQL 分 类 下 。 另外 , 在 窗口 上 方 的 Spring Boot 
Version 下 拉 菜 单 中 ， 可 选取 2.0.0 M5 作为 当前 版 本 。 

在 选取 了 必要 的 依赖 关系 后 ， 当 前 内 容 如 图 4.4 所 示 。 

在 选取 了 依赖 关系 后 ， 单 击 Next 按钮 。 在 接 下 来 的 窗口 中 ， 用 户 将 会 被 询问 提供 项 
目 名 称 以 及 项 目 位 置 。 这 里 ， 可 填写 messenger-api 作为 项 目 名 称 ， 并 选择 项 目 在 计算 机 
上 的 保存 位 置 。 最 后 ， 单 击 Finish 按钮 结束 项 目的 设置 过 程 。 此 时 ， 会 显示 一 个 包含 初 
始 项 目 文件 的 IDE. 窗 
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New Project 
gBoot 200M5Y Sel cies 


图 4.4 选取 依赖 关系 
4.2.3 Spring Boot 概述 


于 当前 Spring Boot 应 用 程序 , 下 面 考察 初始 程序 文件 的 结构 。 图 4.5 显示 了 Spring 
Boot 应 用 程序 文件 的 结构 。 
n 9 位 于 ser 目录 中 ， 该 目录 包含 了 核心 应 用 程序 文件 ， 以 及 针对 给 程序 编 
写 的 测试 程序 。 核 心 应 用 程序 文件 应 置 于 src/main 目录 中 ; 而 测试 程序 则 位 于 src/test 中 。 
男 外 ， et 了 两 个 子 目 录 ， 即 kotlin 目录 和 resources 目录 ， 全 部 数据 包 和 主 源 
文件 均 置 于 该 目录 中 。 特 别 地 ， 当 前 程序 文件 和 数据 包 将 置 于 com.example.messenger.api 
数据 包 中 。 下 面 将 快速 查看 一 下 MessengerApiAplication.kt 文件 ， 如 图 4.6 所 示 。 
JMessengerApiAplication.kt 文 件 包 含 了 主 函 数 ,这 也 是 Spring Boot 应 用 程序 的 入 口 点 。 
当 应 用 程序 启动 时 ， 将 调用 该 函数 。 一 旦 被 调用 ， 该 函数 将 调用 SpringApplication.run() 
函数 。SpringApplication.run() 函 数 接收 两 个 参数 。 其 中 ， 第 一 个 参数 表示 为 类 引用 ; 第 二 
个 参数 在 启动 时 被 传递 至 应 用 程序 中 。 


M 
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messenger-api 


messenger-api ~/Desktop/messenger-api 


图 4.5 Spring Boot 应 用 程序 文件 的 结构 


图 4.6 MessengerApiAplication.kt 文件 


在 同一 文件 中 , 还 定义 了 一 个 MessengerApiApplication 类 , 并 利用 @SpringBootApplication 
进行 注解 。 XX HL, 该 注解 等 同 于 @Configuration、@EnableAutoConfiguration 和 @ComponentScan 
的 组 合 效果 。 采 用 @Configuration 注解 的 类 表示 为 bean 定义 的 来 源 。 


Oss. 


bean 表示 为 一 个 对 象 ， 并 通过 Spring IoC 容器 进行 初始 化 和 装配 


@EnableAutoConfiguration 属性 通知 Spring Boot, Spring 应 用 程序 将 根据 所 提供 的 jar 
依赖 关系 自动 配置 。@ComponentScan 注解 将 配置 (与 @Configuration 类 协同 使 用 的 ) 组 
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件 扫描 目录 。 

在 Spring Boot 应 用 程序 开发 过 程 中 ， 注 解 的 使 用 存在 多 种 原因 。 最 初 使 用 这 些 注 释 
可 能 会 让 人 不 知 所 措 ， 但 随 着 时 间 的 推移 ， 注 解 将 变 成 一 种 自然 的 行为 方式 。 

除了 MessengerApplication.kt 文件 之 外 ， 男 一 个 较为 重要 的 文件 是 application. 
properties， 该 文件 位 于 src/main/resources 中 。 当 打开 该 文件 时 ， 将 会 发 现 其 中 未 包含 任 
何 内 容 ， 其 原因 在 于 : 当前 尚未 定义 任何 应 用 程序 配置 或 属性 。 下 面 尝试 添加 一 组 配置 
信息 ， 并 向 application.properties 文件 中 输入 下 列 内 容 : 

spring.jpa.generate-ddl=true 

spring.jpa.hibernate.ddl-auto-create-drop 

spring.jpa.generate-ddl 属性 用 于 指定 在 应 用 程序 启动 时 是 否 生成 数据 库 模 式 。 当 该 属 
性 设置 为 true 时 , 将 在 应 用 程序 启动 时 生成 数据 库 模 式 。spring.jpa.hibernate.ddl-auto 属性 
则 用 于 指定 DDL 模式 ， 考虑 到 此 处 需要 在 应 用 程序 启动 时 创建 模式 ， 并 在 程序 结束 时 对 
其 进行 销毁 ， 因 而 可 使 用 create-drop。 

上 述 内 容 通 过 属性 定义 了 数据 库 模 式 , 但 尚未 针对 messenger-api 创建 最 终 的 数据 库 。 
如 果 安 装 了 pgAdmin 和 PostgreSQL， 那 么 ， 可 方便 地 利用 这 些 软件 创建 数据 库 。 如 果 读 
者 还 未 安装 pgAdmin， 则 可 通过 PostgreSQL 的 createdb 命令 针对 当前 应 用 程序 创建 数据 
库 。 对 此 ， 读 者 可 在 终端 中 输入 下 列 命令 : 


createdb -h localhost --username=<username> --password messenger-api 


其 中 , -h 标记 用 于 确定 运行 数据 库 服 务 器 的 主机 名 称 。--username 标记 则 用 于 指定 连 
接 到 服务 器 的 用 户 名 。--password 则 要 求 执行 相应 的 密码 规范 。messenger-api 表示 为 数据 
库 设置 的 名 称 。 对 此 ， 读 者 可 利用 自己 的 服务 器 用 户 名 替换 <username>。 在 输入 了 上 述 
命令 行 后 ， 按 Enter 键 并 运行 该 命令 ,同时 输入 对 应 的 密码 。 随 后 ，PostgreSQL 将 创建 名 
为 messenger-api 的 数据 库 。 

在 数据 库 配 置 完毕 后 ， 需 要 将 Spring Boot 应 用 程序 连接 至 该 数据 库 中 。 针 对 于 此 ， 
可 使 用 spring.datasource.url、spring.datasource.username 和 spring.datasource.password 属性 。 
随后 ， 将 下 列 配置 添加 至 application.properties 文件 中 。 

spring.jpa.generate-ddl=true 

spring.jpa.hibernate.ddl-auto-create-drop 

spring.datasource.url-jdbc:postgresql://localhost:5432/messenger-api 


spring.datasource.username-«username» 
Spring.datasource.password-«password» 


spring.datasource.url 属性 通过 Spring Boot 连接 的 数据 库 确定 JDBC URL. 
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spring.datasource.username 和 spring.datasource.password 属性 分 别 用 于 指定 服务 器 用 
户 名 以 及 与 其 关联 的 密码 。 相 应 地 ， 读 者 可 利用 自己 的 用 户 名 和 密码 替换 <username> 和 
<password>. 

在 上 述 属性 配置 完毕 后 ， 即 可 准备 启动 Spring Boot 应 用 程序 。 

通过 单 击 MessengerApiApplication.kt 中 主 函 数 一 侧 的 Kotlin 图 标 , 并 选择 Run 选项 ， 
即 可 运行 messenger-api 应 用 程序 ， 如 图 4.7 所 示 。 


图 4.7 3&fT messenger-api 应 用 程序 


当 项 目 构建 处 理 过 程 完 毕 后 〈 可 能 会 等 待 少许 时 间 ) ， 当 前 应 用 程序 将 在 Tomcat HR 
务 器 上 启动 。 

下 面 继 续 考 察 项 目 中 的 pom.xml 文件 ， 该 文件 位 于 项 目的 根 目 录 中 。 这 里 ，POM 是 
项 目 对 象 模型 的 简写 。 在 Apache Maven 网 站 中 ，POM 解释 如 下 : 项 目 对 象 模型 或 POM 
表示 为 Maven 中 的 基本 工作 单元 ， 并 表示 为 一 个 XML 文件 ， 其 中 包含 了 Maven 所 用 的 
项 目 和 配置 细节 信息 ， 并 以 此 构建 项 目 。 出 于 完整 性 考虑 ， 下 面 简要 地 介绍 一 下 Maven. 

1. Maven 


Apache Maven 是 一 种 基于 POM 概念 的 软件 项 目 管理 和 理解 工具 。Maven 可 以 用 于 
多 种 用 途 ， 例 如 项 目 构建 管理 和 文档 。 
在 理解 了 项 目 文件 之 后 ， 我 们 将 通过 一 些 模型 以 满足 之 前 确定 的 数据 。 
2. 构建 模型 
下 面 将 数据 建 模 至 相应 的 实体 类 中 ， 经 Spring Boot 处 理 后 构建 适宜 的 数据 库 模 式 。 
这 里 第 一 个 考察 的 模型 是 用 户 模型 。 对 此 ， 在 当前 数据 包 中 创建 User.kt 文件 ， 并 输入 下 
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列 代码 : 


package com.example.messenger.api.models 


import 
import 
import 
import 
import 
import 
import 


org.hibernate.validator.constraints.Length 


org.springframework.format.annotation.DateTimeFormat 


java.time.Instant 

java.util.* 

javax.persistence.* 
javax.validation.constraints.Pattern 
javax.validation.constraints.Size 


GEntity 
@Table (name = "'user'"") 
@EntityListeners (UserListener::class) 
class User ( 

@Column (unique = true) 


@Size 
var u 
@Size 


(min = 2) 
sername: String = "", 
(min = 11) 


@Pattern (regexp="“\\ (?(\\d{3}) NV) 2[- 12 (\\d{3}) [- 1? (\\d{4}) $") 


var p 
@size 
var p 
var s 
@Patt 
vara 


) 


honeNumber: String = "", 


(min = 60, max = 60) 

assword: String = "", 

tatus: String = 5", 

ern (regexp = "\\A(activated|deactivated) \\z") 
ccountStatus: String = "activated" 


上 述 代码 块 中 使 用 了 大 量 的 注解 。 首 先 ，@Entity 表明 当前 类 为 Java 持久 化 API 
(JPA) 。 针 对 类 所 表达 的 实体 ，@Table 注解 指定 了 表 名 ， 这 在 方案 生成 期 间 十 分 有 用 。 
如 果 未 使 用 @Table 注解 ， 所 生成 的 表 名 则 表示 为 类 名 。 在 PostgreSQL 中 ,数据 库 表 将 采 
用 名 称 user 加 以 创建 。 顾 名 思 义 ，@EntityListener 针对 实体 类 定义 了 一 个 实体 监听 器 ， 
稍 后 将 对 UserListener 类 加 以 讨论 。 

下 面 考察 User 类 属性 ， 其 中 包含 了 共计 7 个 类 属性 。 其 中 ， 前 5 个 属性 分 别 是 
username, password, phoneNumber, accountStatus 和 status, 代表 了 用 户 所 需 的 数据 类 型 。 
之 前 曾 定义 了 4 个 用 户 实体 ， 但 当前 仍 存在 一 个 问题 一 一 我 们 需要 一 种 方法 可 唯一 辨识 
所 创建 的 每 个 用 户 。 除 此 之 外 ， 还 应 记录 新 用 户 何 时 添加 至 Messenger FAP, 这 对 于 后 


续 参 考 十 分 


EXE, 经 过 仔细 考虑 后 ， 当 前 实体 中 应 定义 id 和 createdAt JEH 


一 一 读者 可 能 


对 此 感到 疑问 , 为 何 要 向 用 户 实体 中 加 入 id 和 createdAt 属性 ? 毕竟 ,我 们 之 前 并 没有 明 
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确 指出 需要 使 用 到 这 类 属性 。 但 这 一 决定 是 正确 的 。 但 是 ， 随 着 开发 过 程 的 逐步 进行 ， 
可 以 在 必要 时 进行 更 改 和 添加 。 下 面 尝试 添加 这 两 个 属性 ， 如 下 所 示 : 


@Entity 
@Table (name = "'user'") 
GEntityListeners (UserListener::class) 
class User( 
@Column (unique = true) 
@Size(min = 2) 
var username: String = "", 
@Size(min = 8, max = 15) 
@Column (unique = true) 
@Pattern (regexp = "*\\(?(\\d{3})\\) 2[- ]?(\\d{3}) [- 1? (\\d{4})$") 
var phoneNumber: String = "", 
@Size(min = 60, max = 60) 
var password: String = "", 
var status: String = "available", 
@Pattern (regexp = "\\A(activated| deactivated) \\z") 
var accountStatus: String = "activated", 
@Id 
@GeneratedValue (strategy = GenerationType.AUTO) 
var id: Long = 0, 
@DateTimeFormat 
var createdAt: Date = Date.from(Instant.now()) 


) 

读者 需要 理解 每 项 注解 的 含义 。 其 中 ，@Column 属性 用 于 指定 表 中 的 各 列 。 在 实际 
操作 过 程 中 ， 所 有 的 实体 属性 均 体现 了 表 中 的 一 列 。 相 应 地 ， 可 在 代码 中 使 用 @Column 
(unique = true)， 并 对 属性 设置 唯一 性 约束 。 若 不 希望 多 条 记录 共用 某 一 特定 属性 值 时 ， 
这 将 十 分 有 用 。 相 信 读 者 已 经 猜 到 @Size， 用 于 指定 表 中 属性 的 尺寸 。@Pattern 用 于 确定 
表 属 性 匹配 的 模式 。 

@Id 属性 用 于 唯一 识别 实体 (此 处 为 id 属性 ) 。@GeneratedValue(strategy = 
GenerationType.AUTO) 负 责 确定 自动 生成 的 id 值 。@DateTimeFormat 将 对 数值 设置 时 间 
X, VEU A TH PIER created at 列 中 。 

下 面 将 定义 UserListener 类 。 对 此 ， 须 创建 一 个 名 为 listeners 的 数据 包 ， 并 向 该 包 中 
添加 UserListener 类 ， 如 下 所 示 : 


package com.example.messenger.api.listeners 


import com.example.messenger.api.models.User 


*138* Kotlin 语言 实例 精 解 


import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder 
import javax.persistence.PrePersist 
import javax.persistence.PreUpdate 


class UserListener ( 


GPrePersist 
@PreUpdate 
fun hashPassword(user: User) { 
user.password = BCryptPasswordEncoder ().encode (user.password) 


} 
} 


注意 ， 在 数据 库 中 ， 密 码 不 可 存储 为 明文 。 出 于 安全 原因 ， 密 码 在 存储 前 须 执 行 哈 
希 计 算 。 相 应 地 ，hashPassword0O 函 数 负责 执行 这 项 任务 ， 也 就 是 说 ， 利 用 哈 希 对 应 值 (使 
用 BCrypt) 替换 用 户 对 象 密码 属性 所 持 有 的 字符 串 。@PrePersist 和 @PreUpdate 用 于 指定 
该 函数 应 在 数据 库 用 户 记录 持久 化 或 更 新 之 前 被 调用 。 

下 面 创 建 一 个 消息 实体 ， 在 models 数据 包 中 定义 Message 类 ， 并 向 该 类 中 添加 下 列 
代码 : 


package com.example.messenger.api.models 


import org.springframework.format.annotation.DateTimeFormat 
import java.time.Instant 

import java.util.* 

import javax.persistence.* 


GEntity 
class Message( 
@ManyToOne (optional = false) 
@JoinColumn(name = "user id", referencedColumnName = "id") 
var sender: User? = null, 
@ManyToOne (optional = false) 
@JoinColumn (name = "recipient id", referencedColumnName = "id") 
var recipient: User? = null, 
var body: String? = "", 
@ManyToOne (optional = false) 
@JoinColumn (name="conversation_id", referencedColumnName = "id") 
var conversation: Conversation? = null, 
@Id @GeneratedValue (strategy = GenerationType.AUTO) var id: Long = 0, 
@DateTimeFormat 
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var createdAt: Date = Date.from(Instant.now()) 


) 


除了 之 前 所 讨论 的 注解 之 外 ， 代 码 中 还 新 加 入 了 两 个 注解 。 如 前 所 述 ， 每 条 消息 均 
包含 了 一 个 发 送 者 和 一 个 接收 者 ， 且 均 表示 为 平台 中 的 用 户 。 因 此 ， 消 息 实体 中 包含 了 
User 类 型 的 发 送 者 和 接收 者 属性 。 这 里 ， 用 户 可 表示 为 多 条 消息 的 发 送 者 ， 以 及 多 条 消 
息 的 接收 者 ， 这 一 关系 需要 在 实际 操作 过 程 中 予以 实现 。 此 外 ， 还 可 使 用 @ManyToOne 
注解 实现 这 一 功能 ,对 于 多 对 一 关系 , 可 使 用 @ManyToOne(optional = false). @JoinColumn 
则 指定 了 一 个 列 ， 用 于 连接 实体 关联 或 元 素 集合 ， 如 下 所 示 : 


@JoinColumn(name = "user id", referencedColumnName = "id") 


var sender: User? = null 


上 述 代 码 片 段 加 入 了 一 个 user id 属性 ， 该 属性 将 用 户 的 id 引用 到 消息 表 。 

读者 可 能 已 经 注意 到 ，Message 类 中 使 用 了 会 话 属性 。 这 是 因为 用 户 之 间 发 送 的 消息 
发 生 在 会 话 线程 中 。 简 单 地 说 ， 每 个 消息 都 属于 一 个 线程 。 我 们 需要 在 models 包 中 添加 
一 个 Conversation 类 ， 代 表 对 话 实体 ， 如 下 所 示 : 


package com.example.messenger.api.models 


import org.springframework.format.annotation.DateTimeFormat 
import java.time.Instant 

import java.util.* 

import javax.persistence.* 


GEntity 
class Conversation( 
@ManyToOne (optional = false) 
@JoinColumn (name = "sender id", referencedColumnName = "id") 
var sender: User? - null, 
@ManyToOne (optional = false) 


GJoinColumn(name = "recipient id", referencedColumnName = "id") 
var recipient: User? - null, 
@Id 


@GeneratedValue (strategy = GenerationType.AUTO) 
var id: Long = 0, 

@DateTimeFormat 

val createdAt: Date = Date.from(Instant.now()) 


ya 


@OneToMany (mappedBy = "conversation", targetEntity = 
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Message::class) 
private var messages: Collection«Message»? = null 


} 


其 中 , 多 个 消息 均 属 于 一 个 会 话 , 因此 我 们 在 Conversation %4 rri — messages 
集合 。 
实体 横 型 的 创建 过 程 已 基本 完成 ， 剩 下 的 工作 是 为 用 户 发 送 和 接收 的 消息 添加 适当 
的 集合 ， 如 下 所 示 : 


package com.example.messenger.api.models 


import com.example.messenger.api.listeners.UserListener 
import org.springframework.format.annotation.DateTimeFormat 
import java.time.Instant 

import java.util.* 

import javax.persistence.* 

import javax.validation.constraints.Pattern 

import javax.validation.constraints.Size 


GEntity 
@Table (name = "`user`") 
@EntityListeners (UserListener::class) 
class User ( 
@Column (unique = true) 
@Size(min = 2) 
var username: String = A 
@Size(min = 8, max = 15) 
@Column (unique = true) 
GPattern(regexp = "*\\(?(\\d{3})\\) 2[- 1? (\\d{3}) [- 1? (\\d{4})$") 
var phoneNumber: String = "", 
@Size(min = 60, max = 60) 
var password: String = "", 


var status: String = "available", 

@Pattern (regexp = "\\A(activated|deactivated) \\z") 
var accountStatus: String = "activated", 

Gerd 


@GeneratedValue (strategy = GenerationType.AUTO) 

var id: Long - 0, 

GDateTimeFormat 

var createdAt: Date - Date.from(Instant.now()) 
rt 


//collection of sent messages 
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@OneToMany (mappedBy = "sender", targetEntity = Message::class) 
private var sentMessages: Collection<Message>? = null 


//collection of received messages 
@OneToMany (mappedBy = "recipient", targetEntity = Message::class) 
private var receivedMessages: Collection<Message>? = null 


} 


至 此 ， 我 们 完成 了 实体 创建 过 程 。 为 了 帮助 读者 理解 所 创建 的 实体 及 其 关系 ， 图 4.8 
显示 了 一 幅 实 体 关系 图 CE-R 图 ) ， 并 体现 了 已 经 建立 的 实体 以 及 实体 间 的 关系 。 


图 4.8 实体 关系 图 


根据 E-R 图 ， 不 难 发 现 ， 用 户 可 包含 多 个 消息 ; 而 一 条 消息 可 隶属 于 某 个 用 户 ; 消 
息 可 属于 某 个 会 话 ， 某 个 会 话 可 包含 多 个 消息 。 除 此 之 外 ， 用 户 也 可 包含 多 个 会 话 。 


在 模型 创建 完毕 后 ， 目 前 仅 剩 下 一 个 问题 
下 面 将 创建 存储 库 以 解决 这 一 问题 。 

3. 创建 存储 库 

Spring Data JPA 可 在 运行 时 从 存储 库 接 口中 自动 生成 存储 库 实现 。 下 面 将 创建 一 个 
存储 库 ， 并 访问 User 实体 ， 进 而 查看 其 工作 方式 。 首 先 ， 创 建 repositories 数据 包 ， 并 将 
其 纳入 UserRepository.kt 文件 中 ， 如 下 所 示 : 


尚 无 法 访问 存储 于 此 类 实体 中 的 数据 。 
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package com.example.messenger.api.repositories 


import com.example.messenger.api.models.User 
import org.springframework.data.repository.CrudRepository 


interface UserRepository : CrudRepository<User, Long> { 
fun findByUsername (username: String): User? 


fun findByPhoneNumber (phoneNumber: String): User? 
} 


其 中 ，UserRepository 扩展 了 CrudRepository 接口 ， 其 所 协同 工作 的 entity 类 型 和 id 
类 型 通过 CrudRepository 的 泛 型 参数 指定 。 通 过 扩展 CrudRepository, UserRepository 4k 
承 了 User 持久 化 方法 ， 例 如 保存 方法 、 搜 索 方法 以 及 删除 User 实体 的 方法 。 

Spring JPA 允许 使 用 方法 签名 声明 其 他 查询 函数 。 我 们 可 利用 这 一 功能 创建 
findByUsername()fll findByPhoneNumber() i 2X. 

当前 定义 了 3 个 实体 , 因而 需要 设置 3 个 存储 库 对 其 进行 查询 ,对 此 ,可 在 repositories 
中 定义 MessageRepository 接口 ， 如 下 所 示 : 


package com.example.messenger.api.repositories 


import com.example.messenger.api.models.Message 
import org.springframework.data.repository.CrudRepository 


interface MessageRepository : CrudRepository<Message, Long» { 
fun findByConversationId(conversationId: Long): List<Message> 


) 

需要 注意 的 是 ， 上 述 方 法 签名 将 List<Message> 指 定 为 返回 类 型 。Spring IPA 可 对 此 
自动 识别 ， 并 在 调用 findByConversationIdO 时 返回 Message 元 素 列 表 。 

最 后 ， 还 需 实现 ConversationRepository 接口 ， 如 下 所 示 : 

package com.example.messenger.api.repositories 


import com.example.messenger.api.models.Conversation 
import org.springframework.data.repository.CrudRepository 


interface ConversationRepository : CrudRepository<Conversation, Long> { 
fun findBySenderId(id: Long): List<Conversation> 
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fun findByRecipientId(id: Long): List<Conversation> 


fun findBySenderIdAndRecipientId(senderId: Long, 
recipientId: Long): Conversation? 

} 

由 于 已 经 定义 了 实体 集 和 必要 的 存储 库 来 查询 这 些 实体 ， 所 以 可 以 开始 执行 
Messenger 后 端的 业务 逻辑 。 对 此 ， 需 要 了 解 服务 和 服务 实现 。 

4. 服务 和 服务 实现 

服务 实现 定义 为 一 个 Spring bean， 并 通过 @Service 予以 标记 。Spring 应 用 程序 的 业 
务 逻 辑 一 般 置 于 服务 实现 中 。 另 外 一 方面 ， 服 务 也 表示 为 一 个 接口 ， 并 包含 了 须 进 一 步 
实现 的 应 用 程序 函数 签名 。 简 而 言 之 ， 服 务 定 义 为 一 个 接口 ， 而 服务 实现 则 表示 为 实现 
了 该 服务 的 类 。 

下 面 尝 试 创建 服务 以 及 服务 实现 。 对 此 ， 可 构建 service 数据 包 ， 并 将 服务 和 服务 实 
现 添加 于 其 中 。 在 该 数据 包 中 ， 可 定义 UserService 接口 ， 对 应 代码 如 下 所 示 : 


package com.example.messenger.api.services 


import com.example.messenger.api.models.User 


interface UserService { 
fun attemptRegistration(userDetails: User): User 


fun listUsers(currentUser): List<User> 
fun retrieveUserData (username: String): User? 
fun retrieveUserData(id: Long): User? 


fun usernameExists (username: String): Boolean 


} 


TE EXR UserService 接口 中 ， 所 定义 的 函数 须 在 实现 了 UserService 的 类 中 加 以 声明 。 
下 面 着 手 创 建 服 务实 现 。 相 应 地 ， 将 UserServicelmpl 类 添加 至 services 包 中 ， 当 实现 
UserService I, 53278 *j attemptRegistration() . listUsers() ~ retrieveUserData() 以 及 
usernameExists0 〇 函数 ， 如 下 所 示 : 


package com.example.messenger.api.services 


import com.example.messenger.api.exceptions.InvalidUserIdException 
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import com.example.messenger.api.exceptions.UserStatusEmptyException 
import com.example.messenger.api.exceptions.UsernameUnavailableException 
import com.example.messenger.api.models.User 

import com.example.messenger.api.repositories.UserRepository 

import org.springframework.stereotype.Service 


@Service 
class UserServiceImpl (val repository: UserRepository) : UserService { 
@Throws (UsernameUnavailableException::class) 
override fun attemptRegistration(userDetails: User): User { 
if (!usernameExists(userDetails.username)) { 
val user = User() 
user.username = userDetails.username 
user.phoneNumber = userDetails.phoneNumber 
user.password = userDetails.password 
repository.save (user) 
obscurePassword (user) 
return user 
) 
throw UsernameUnavailableException ("The username 
${userDetails.username} is unavailable.") 


@Throws (UserStatusEmptyException::class) 
fun updateUserStatus (currentUser: User, updateDetails: User): User { 
if (!updateDetails.status.isEmpty()) { 
currentUser.status = updateDetails.status 
repository. save (currentUser) 
return currentUser 
} 
throw UserStatusEmpt yException () 
} 


override fun listUsers(currentUser: User): List<User> { 
return repository.findAll().mapTo(ArrayList(), { it }) 
.filter( it !- currentUser } 


override fun retrieveUserData (username: String): User? { 
val user - repository.findByUsername (username) 
obscurePassword (user) 
return user 
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QThrows (InvalidUserIdException::class) 
override fun retrieveUserData(id: Long): User { 
val userOptional = repository.findById (id) 
if (userOptional.isPresent) ( 
val user = userOptional.get() 
obscurePassword (user) 
return user 
) 
throw InvalidUserIdException("A user with an id of '$id' 
does not exist.") 


) 


override fun usernameExists (username: String): Boolean { 
return repository.findByUsername (username) != null 


} 


private fun obscurePassword(user: User?) { 
user?.password = "XXX XXXX XXX" 
} 
} 


在 UserServiceImpl 的 主 构造 函数 中 , UserRepository 的 实例 定义 为 所 需 的 参数 。 读 者 
无 须 对 传递 此 类 参数 而 感到 担心 。Spring 意识 到 UserServiceImpl 需要 一 个 UserRepository 
实例 ， 并 通过 依赖 注入 为 该 类 提供 一 个 实例 。 除 了 所 实现 的 函数 之 外 ， 此 处 还 声明 了 一 个 
obscurePasswordO 函 数 , 该 函数 使 用 XXX XXXX XXX 对 User 实体 中 的 密码 进行 哈 希 处 理 。 

依据 之 前 所 讨论 的 服务 和 服务 实现 构建 原则 ， 下 面 继续 为 消息 和 对 话 增加 一 些 内 容 ， 
并 向 service 中 添加 MessageService 接口 ， 如 下 所 示 : 


package com.example.messenger.api.services 


import com.example.messenger.api.models.Message 
import com.example.messenger.api.models.User 


interface MessageService { 


fun sendMessage(sender: User, recipientId: Long, 
messageText: String): Message 


} 


此 处 针对 sendMessage0 添 加 了 一 个 方法 签名 ， 该 签名 必须 由 MessageServiceImpl 所 
覆 写 。 以 下 是 消息 服务 的 实现 过 程 : 
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package com.example.messenger.api.services 


import com.example.messenger.api.exceptions.MessageEmptyException 
import 

com.example.messenger.api.exceptions .MessageRecipientInvalidException 
import com.example.messenger.api.models.Conversation 

import com.example.messenger.api.models.Message 

import com.example.messenger.api.models.User 

import com.example.messenger.api.repositories.ConversationRepository 
import com.example.messenger.api.repositories.MessageRepository 
import com.example.messenger.api.repositories.UserRepository 

import org.springframework.stereotype.Service 


GService 

class MessageServiceImpl(val repository: MessageRepository, 
val conversationRepository: ConversationRepository, 
val conversationService: ConversationService, 
val userRepository: UserRepository) : MessageService ( 


@Throws (MessageEmptyException::class, 
MessageRecipientInvalidException::class) 
override fun sendMessage (sender: User, recipientId: Long, 

messageText: String): Message { 
val optional = userRepository.findById (recipientId) 


if (optional.isPresent) { 
val recipient = optional.get() 


if (!messageText.isEmpty()) { 

val conversation: Conversation - if (conversationService 

-conversationExists (sender, recipient)) { 
conversationService.getConversation(sender, recipient) 
as Conversation 

) else ( 

conversationService.createConversation(sender, recipient) 
) 


conversationRepository.save (conversation) 


val message - Message(sender, recipient, messageText, 
conversation) 

repository.save (message) 

return message 
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} 

} else { 
throw MessageRecipientInvalidException("The recipient id 

'$recipientId' is invalid.") 
n 
throw MessageEmpt yException () 
} 
} 


上 述 sendMessageO 实 现 首先 判断 消息 内 容 是 否 为 空 。 若 否 ， 该 函数 将 检测 是 否 存在 
发 送 者 和 接收 者 之 间 的 一 个 活动 会 话 。 若 是 ， 则 该 会 话 存储 于 conversation 中 ; 否则 ， 则 
创建 两 个 用 户 间 的 一 个 会 话 ， 并 将 其 存储 于 conversation 中 。 随 后 ， 会 话 将 被 保存 ， 并 创 
建 、 保 存 当 前 消息 。 

下 面 实现 ConversationService 和 ConversationServiceImpl。 对 此 ， 可 在 services 中 定 
义 ConversationService 接口 ， 并 添加 下 列 代码 : 


package com.example.messenger.api.services 


import com.example.messenger.api.models.Conversation 
import com.example.messenger.api.models.User 


interface ConversationService { 


fun createConversation (userA: User, userB: User): Conversation 

fun conversationExists(userA: User, userB: User): Boolean 

fun getConversation(userA: User, userB: User): Conversation? 

fun retrieveThread(conversationId: Long): Conversation 

fun listUserConversations(userId: Long): List<Conversation> 

fun nameSecondParty (conversation: Conversation, userId: Long): String 


) 

其 中 包含 6 个 函数 签名 , HI createConversation(). conversationExists(). getConversation() . 
retrieveThread(). listUserConversations()fll nameSecondParty0。 当 前 ， 还 应 向 services 中 
添加 ConversationServiceImpl ， 并 实现 前 3 个 方法 ， 即 createConversation() ~ 
conversationExists() 和 getConversation() 方 法 。 对 应 实现 过 程 如 下 所 示 : 


package com.example.messenger.api.services 
import com.example.messenger.api.exceptions.ConversationlIdInvalidException 


import com.example.messenger.api.models.Conversation 
import com.example.messenger.api.models.User 
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import com.example.messenger.api.repositories.ConversationRepository 
import org.springframework.stereotype.Service 


@Service 
class ConversationServiceImpl (val repository: 
ConversationRepository) :ConversationService { 


override fun createConversation(userA: User, userB: User): 
Conversation { 
val conversation = Conversation(userA, userB) 
repository. save (conversation) 
return conversation 


override fun conversationExists(userA: User, userB: User): Boolean { 
return if (repository.findBySenderIdAndRecipientId 


(userA.id, userB.id) != null) 
true 
else repository. findBySenderIdAndRecipientId 
(userB.id, userA.id) != null 


override fun getConversation(userA: User, userB: User): Conversation? { 
return when { 
repository. findBySenderIdAndRecipientId(userA.id, 
userB.id) != null -> 
repository. findBySenderIdAndRecipientId(userA.id, userB.id) 
repository. findBySenderIdAndRecipientId(userB.id, 
userA.id) != null -> 
repository. findBySenderIdAndRecipientId(userB.id, userA.id) 
else -> null 


} 


在 添加 了 前 3 个 方法 后 ,下 面 继续 向 ConversationServiceImpl 中 加 入 retrieveThread(). 
listUserConversations() fll nameSecondParty0 方 法 ， 如 下 所 示 : 


override fun retrieveThread(conversationId: Long): Conversation { 
val conversation = repository.findById(conversationId) 


if (conversation.isPresent) ( 
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return conversation.get() 
} 
throw ConversationIdInvalidException("Invalid conversation id 
'$conversationId'") 


override fun listUserConversations (userId: Long): 
ArrayList<Conversation> { 
val conversationList: ArrayList<Conversation> = ArrayList () 
conversationList.addAll (repository. findBySenderId (userId) ) 
conversationList.addAll (repository. findByRecipientId (userId) ) 


return conversationList 


override fun nameSecondParty (conversation: Conversation, 
userId: Long): String { 


return if (conversation.sender?.id == userId) { 
conversation.recipient?.username as String 
} else { 


conversation.sender?.username as String 


} 

读者 可 能 已 经 注意 到 ， 在 服务 实现 类 中 ， 多 次 抛 出 了 不 同类 型 的 异常 。 对 此 ， 应 对 
此 类 异常 加 以 定义 。 另 外 ， 还 需 针 对 每 个 异常 定义 一 个 ExceptionHandler。 这 一 类 异常 处 
理 程 序 将 在 抛 出 异常 时 向 客户 端 发 送 适 当 的 错误 响应 。 

EFK, TEJE exceptions 数据 包 ， 向 其 中 添加 AppExceptions.kt 文件 ， 并 在 该 文件 
中 加 入 下 列 代码 : 


package com.example.messenger.api.exceptions 


class UsernameUnavailableException(override val message: String) : 
RuntimeException () 


class InvalidUserIdException(override val message: String) : 
RuntimeException () 


class MessageEmptyException(override val message: String = "A message 
cannot be empty.") : RuntimeException() 


class MessageRecipientiInvalidException(override val message: String) : 
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RuntimeException () 


class ConversationIdInvalidException (override val message: String) 


RuntimeException () 


class UserDeactivatedException (override val message: String) : 
RuntimeException () 


class UserStatusEmptyException (override val message: String = "A user's 


status 


cannot be empty") : RuntimeException() 


对 于 服务 器 运行 期 内 出 现 的 异常 ， 每 个 异常 将 扩展 RuntimeException。 同 时 ， 所 有 异 
常 都 具有 message 属性 。 顾 名 思 义 ， 这 一 类 消息 称 作 异常 消息 。 在 异常 添加 完毕 后 ， 还 
需要 创建 控制 器 设备 类 。ControllerAdvice 类 用 于 处 理 出 现 于 Spring 应 用 程序 中 的 错误 ， 
并 通过 @ControllerAdvice 注解 创建 。 另 外 ， 控 制 器 设备 表示 为 Spring 组 件 类 型 。 下 面 将 
构建 控制 器 设备 类 ， 并 对 上 述 异常 进行 处 理 。 

下 面 考察 UsemameUnavailableException, InvalidUserldException 和 UserStatusEmptyException, 
需要 注意 的 是 ， 这 3 个 异常 均 与 用 户 相 关 。 因 此 ， 可 将 当前 控制 器 设备 命名 为 
UserControllerAdvice。 下 面 创建 components 数据 包 ， 并 将 UserControllerAdvice 类 添加 于 
其 中 ， 如 下 所 示 : 


package com.example.messenger.api.components 


import 
import 
import 
import 
import 
import 
import 
import 


com.example.messenger.api.constants.ErrorResponse 
com.example.messenger.api.constants.ResponseConstants 
com.example.messenger.api.exceptions.InvalidUserIdException 
com.example.messenger.api.exceptions.UserStatusEmptyException 
com.example.messenger.api.exceptions.UsernameUnavailableException 
org.springframework.http.ResponseEntity 
org.springframework.web.bind.annotation.ControllerAdvice 
org.springframework.web.bind.annotation.ExceptionHandler 


GControllerAdvice 
class UserControllerAdvice ( 


@ExceptionHandler (UsernameUnavailableException::class) 


fun usernameUnavailable (usernameUnavailableException: 


UsernameUnavailableException): 


ResponseEntity<ErrorResponse> { 
val res = ErrorResponse (ResponseConstants.USERNAME UNAVAILABLE 
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-value, usernameUnavailableException.message) 
return ResponseEntity.unprocessableEntity () .body (res) 


) 


@ExceptionHandler (InvalidUserIdException::class) 
fun invalidId(invalidUserIdException: InvalidUserIdException): 
ResponseEntity<ErrorResponse> { 
val res = ErrorResponse (ResponseConstants.INVALID USER ID.value, 
invalidUserIdException.message) 
return ResponseEntity.badRequest () .body (res) 
} 


@ExceptionHandler (UserStatusEmptyException::class) 
fun statusEmpty (userStatusEmptyException: UserStatusEmptyException) : 
ResponseEntity<ErrorResponse> { 
val res = ErrorResponse (ResponseConstants.EMPTY STATUS.value, 
userStatusEmpt yException.message) 

return ResponseEntity.unprocessableEntity () .body (res) 

} 

} 


我 们 刚刚 定义 了 相关 函数 , 以 满足 可 能 出 现 的 3 个 异常 , 并 使 用 @ExceptionHanlderO 
注释 每 个 函数 。(@ExceptionHanlder0 接 收 一 个 指向 异常 的 类 引用 。 每 个 函数 都 接收 一 个 
参数 ， 该 参数 是 所 抛 出 的 异常 实例 。 除 此 之 外 ， 全 部 定义 后 的 函数 均 返 回 ResponseEntity 
<ErrorResponse> 实 例 。 响 应 实体 表示 发 送 到 客户 端的 整个 HTTP 响应 。 

当前 并 未 创建 ErrorResponse。 下 面 生成 constants 数据 包 ， 并 将 ErrorResponse 添加 
至 其 中 ， 如 下 所 示 : 


package com.example.messenger.api.constants 


class ErrorResponse(val errorCode: String, val errorMessage: String) 


ErrorResponse 类 包含 两 个 属性 ， 即 errorCode 和 errorMessage。 在 进行 讨论 之 前 ， 首 
先 需要 将 ResponseConstants 枚 举 类 添加 至 constants 数据 包 中 ， 如 下 所 示 : 


package com.example.messenger.api.constants 


enum class ResponseConstants(val value: String) { 
SUCCESS ("success"), ERROR("error"), 
USERNAME UNAVAILABLE ("USR 0001"), 
INVALID USER ID("USR 002"), 
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EMPTY STATUS ("USR 003"), 
MESSAGE EMPTY("MES 001"), 
MESSAGE RECIPIENT INVALID("MES 002"), 
ACCOUNT DEACTIVATED ("GLO 001") 
) 


下 面 创建 3 个 控制 器 设备 类 , 即 MessageControllerAdvice. ConversationControllerAdvice 
和 RestControllerAdvice。 其 中 ，RestControllerAdvice 针对 服务 器 运行 过 程 中 的 错误 定义 
了 异常 处 理 机 制 。 

MessageControllerAdvice 类 定义 如 下 所 示 : 


package com.example.messenger.api.components 


import com.example.messenger.api.constants.ErrorResponse 

import com.example.messenger.api.constants.ResponseConstants 

import com.example.messenger.api.exceptions.MessageEmptyException 
import 
com.example.messenger.api.exceptions.MessageRecipientInvalidException 
import org.springframework.http.ResponseEntity 

import org.springframework.web.bind.annotation.ControllerAdvice 
import org.springframework.web.bind.annotation.ExceptionHandler 


GControllerAdvice 
class MessageControllerAdvice ( 
GExceptionHandler (MessageEmptyException::class) 
fun messageEmpty (messageEmptyException: MessageEmptyException): 
ResponseEntity<ErrorResponse> { 
//ErrorResponse object creation 
val res = ErrorResponse (ResponseConstants.MESSAGE EMPTY.value, 
messageEmptyException.message) 


// Returning ResponseEntity containing appropriate ErrorResponse 
return ResponseEntity.unprocessableEntity () .body (res) 


@ExceptionHandler (MessageRecipientInvalidException::class) 
fun messageRecipientInvalid (messageRecipientInvalidException: 
MessageRecipientInvalidException): 
ResponseEntity<ErrorResponse> { 
val res = ErrorResponse (ResponseConstants.MESSAGE RECIPIENT INVALID 
-value, messageRecipientInvalidException.message) 
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return ResponseEntity.unprocessableEntity () .body (res) 


} 
ConversationControllerAdvice 类 定义 如 下 所 示 : 


package com.example.messenger.api.components 


import com.example.messenger.api.constants.ErrorResponse 

import 
com.example.messenger.api.exceptions.ConversationIdInvalidException 
import org.springframework.http.ResponseEntity 

import org.springframework.web.bind.annotation.ControllerAdvice 
import org.springframework.web.bind.annotation.ExceptionHandler 


GControllerAdvice 
class ConversationControllerAdvice ( 
GExceptionHandler 
fun conversationIdInvalidException (conversationIdInvalidException: 
ConversationIdInvalidException): ResponseEntity<ErrorResponse> { 
val res = ErrorResponse("", conversationIdInvalidException.message) 
return ResponseEntity.unprocessableEntity () .body (res) 


) 
Hi, RestControllerAdvice 类 定义 如 下 所 示 : 


package com.example.messenger.api.components 


import com.example.messenger.api.constants.ErrorResponse 

import com.example.messenger.api.constants.ResponseConstants 

import com.example.messenger.api.exceptions.UserDeactivatedException 
import org.springframework.http.HttpStatus 

import org.springframework.http.ResponseEntity 

import org.springframework.web.bind.annotation.ControllerAdvice 


import org.springframework.web.bind.annotation.ExceptionHandler 


@ControllerAdvice 
class RestControllerAdvice { 


@ExceptionHandler (UserDeactivatedException::class) 
fun userDeactivated (userDeactivatedException: 
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UserDeactivatedException): 
ResponseEntity<ErrorResponse> { 
val res = ErrorResponse (ResponseConstants.ACCOUNT DEACTIVATED 
-value, userDeactivatedException.message) 


// Return an HTTP 403 unauthorized error response 
return ResponseEntity(res, HttpStatus.UNAUTHORIZED) 
} 
} 
上 述 内 容 实 现 了 业务 逻辑 ， 在 通过 REST 端点 将 HTTP 请 求 置 入 API 之 前 ， 须 确保 
API 的 安全 性 。 


4.2.4 限制 API 访问 


允许 任何 人 访问 RESTful API 资源 可 视 为 一 种 安全 大 忌 。 针 对 于 此 ， 须 设计 一 种 方 
法 ,将 服务 器 的 访问 限定 为 注册 用 户 和 登录 用 户 。 我 们 将 使 用 Spring Security 和 JSON Web 
Tokens (JWTs) 来 实现 这 一 功能 。 

1. Spring Security 

Spring Security 是 一 个 针对 Spring 应 用 程序 的 、 高 度 可 定制 的 访问 控制 框架 ， 同 时 也 
是 一 种 被 公认 的 标准 ， 用 于 保护 Spring 构建 的 应 用 程序 。 通 常 在 项 目的 开始 阶段 被 选择 
用 来 添加 安全 依赖 。 当 前 项 目 并 不 需要 向 pom 添加 Spring 安全 依赖 〈 已 添加 完毕 ) 。 

2. JSON Web Tokens 

JSON Web Tokens 是 一 种 开放 的 行业 标准 方法 ， 用 于 在 双方 之 间 安 全 地 表示 声明 。 
JWTs 允许 解码 、 验 证 和 生成 JWT 等 操作 。JWTs 可 以 很 容易 地 使 用 Spring Boot 来 实现 
应 用 程序 中 的 身份 验证 。 下 面 将 演示 如 何 使 用 JWTs 和 Spring Security 组 合 来 保护 
Messenger 后 端 程序 。 

当 在 Spring 应 用 程序 中 使 用 JWTs 时 ， 首 先 需 要 将 JWTs 的 依赖 关系 添加 到 项 目的 
pom.xml 文件 中 ， 如 下 所 示 : 


<dependencies> 


<dependency> 
<groupId>io.jsonwebtoken</groupId> 
<artifactId>jjwt</artifactId> 
<version>0.7.0</version> 
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</dependency> 
</dependencies> 


当 在 pom.xml 中 设置 了 新 的 Maven (KM KAM, IntelliJ 将 提示 导入 新 的 依赖 关系 ， 
如 图 4.9 所 示 。 


artifactId> 


® Maven projects need to be imported 


Fd 4.9 IntelliJ 提示 导入 新 的 依赖 关系 
在 显示 提示 信息 后 ， 单 击 Import Changes 按钮 ，JWT 依赖 关系 将 导入 当前 项 目 中 。 
3. 配置 Web 安全 


首先 需要 构建 自 定 义 Web 安全 配置 。 对 此 ， 可 在 com.example.messenger.api 中 创建 
config 数据 包 ， 将 WebSecurityConfig 类 添加 至 该 数据 包 中 ， 并 输入 下 列 代码 : 


package com.example.messenger.api.config 


import com.example.messenger.api.filters.JWTAuthenticationFilter 
import com.example.messenger.api.filters.JWTLoginFilter 

import com.example.messenger.api.services.AppUserDetailsService 
import org.springframework.context.annotation.Configuration 

import org.springframework.http.HttpMethod 

import 
org.springframework.security.config.annotation.authentication.builders. 
AuthenticationManagerBuilder 

import 
org.springframework.security.config.annotation.web.builders.HttpSecurity 
import 
org.springframework.security.config.annotation.web.configuration. 
EnableWebSecurity 

import 
org.springframework.security.config.annotation.web.configuration. 
WebSecurityConfigurerAdapter 
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import org.springframework.security.core.userdetails.UserDetailsService 
import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder 
import 
org.springframework.security.web.authentication.UsernamePasswordAuthen 
ticationFilter 


GConfiguration 

GEnableWebSecurity 

class WebSecurityConfig(val userDetailsService: AppUserDetailsService) 
: WebSecurityConfigurerAdapter() ( 


@Throws (Exception::class) 
override fun configure(http: HttpSecurity) { 
http.csrf().disable() .authorizeRequests () 
.antMatchers (HttpMethod.POST, "/users/registrations") 
.permitAll() 
.antMatchers (HttpMethod.POST, "/login").permitAll() 
.anyRequest () . authenticated() 
.and() 


过 滤 /login 请 求 ， 如 下 所 示 : 
.addFilterBefore (JWTLoginFilter("/login", 


authenticationManager()), 
UsernamePasswordAuthenticationFilter::class.java) 


过 滤 其 他 请 求 ， 并 检测 数据 头 中 是 否 存在 JWT， 如 下 所 示 : 


.addFilterBefore (JWTAuthenticationFilter(), 
UsernamePasswordAuthenticationFilter::class.java) 


@Throws (Exception::class) 
override fun configure(auth: AuthenticationManagerBuilder) ( 
auth.userDetailsService«UserDetailsService» (userDetailsService) 
-passwordEncoder (BCryptPasswordEncoder ()) 


} 


FL}, WebSecurityConfig 利用 @EnableWebSecurity 进行 标注 ， 这 将 开启 Spring Security 
的 Web 安全 支持 。 除 此 之 外 ，WebSecurityConfig 扩展 了 WebSecurityConfigurerAdapter, Jf 
Ti SHA configure0 方 法 ， 并 向 Web 安全 配置 中 加 入 了 某 些 自 定义 内 容 。 
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configure(HttpSecurity) 方 法 负责 配置 安全 的 URL 路 径 。 在 WebSecurityConfig H, fù 
许 所 有 对 /users/registration 和 /login 路 径 的 POST 请 求 。 这 两 个 端点 不 需要 受到 保护 ， 
为 用 户 在 登录 或 在 平台 上 注册 之 前 不 能 进行 身份 验证 。 此 外 ， 我 们 还 为 请 求 添加 了 过 滤 
器 。 对 /loign 的 请 求 将 被 JWTLoginFilter 过 滤 〈 当 前 尚未 实现 这 一 功能 ) ; 所 有 未 经 身份 
验证 和 所 禁止 的 请 求 都 将 被 JWTAuthenticationFilter 过 滤 〈 当 前 尚未 实现 这 一 功能 ) 。 

configure(AuthenticationManagerBuilder) 负 责 设置 UserDetailsService， 并 指定 所 采用 

如 前 所 述 ， 目 前 ， 尚 有 多 个 类 还 未 予 实现 。 下 面 首先 定义 JWTLosginFilter。 对 此 ， 可 
创建 名 为 filters 的 新 数据 包 ， 并 添加 IWTLoginFilter 类 ， 如 下 所 示 : 


package com.example.messenger.api.filters 


import com.example.messenger.api.security.AccountCredentials 
import com.example.messenger.api.services.TokenAuthenticationService 
import com.fasterxml.jackson.databind.ObjectMapper 


import org.springframework.security.authentication.AuthenticationManager 
import 
org.springframework.security.authentication.UsernamePasswordAuthenticationToken 
import org.springframework.security.core.Authentication 

import org.springframework.security.core.AuthenticationException 
import 
org.springframework.security.web.authentication.AbstractAuthentication 
ProcessingFilter 

import org.springframework.security.web.util.matcher. 
AntPathRequestMatcher 


import javax.servlet.FilterChain 

import javax.servlet.ServletException 

import javax.servlet.http.HttpServletRequest 
import javax.servlet.http.HttpServletResponse 
import java.io.IOException 


class JWTLoginFilter(url: String, authManager: 
AuthenticationManager) :AbstractAuthenticationProcessingFilter 
(AntPathRequestMatcher (url))í 


ipit i 


authenticationManager = authManager 
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@Throws (AuthenticationException::class, 
ServletException::class) 


override fun attemptAuthentication( req: HttpServletRequest, 
res: HttpServletResponse): Authentication( 


val credentials = ObjectMapper () 


IOException::class, 


-readValue (req.inputStream, AccountCredentials::class.java) 


return authenticationManager.authenticate ( 
UsernamePasswordAuthenticationToken ( 
credentials.username, 
credentials.password, 
emptyList () 


@Throws (IOException::class, ServletException::class) 
override fun successfulAuthentication ( 
req: HttpServletRequest, 
res: HttpServletResponse, chain: FilterChain, 
auth: Authentication) { 
TokenAuthenticationService.addAuthentication(res, 


} 
} 


auth.name) 


JWTLoginFilter 接收 字符 串 URL， 以 及 一 个 AuthenticationManager 实例 作为 主 构造 


函数 的 参数 ， 同 时 扩展 了 AbstractAuthenticationProcessingFilter。 该 过 滤器 拦截 发 向 


民 务 器 


HJ HTTP 请 求 , 并 对 其 进行 验证 。 相应 地 , attemptAuthentication0 负 责 执行 实 际 的 验证 过 程 ， 
并 利用 ObjectMapper0 实 例 读 取 via HTTP 请 求 中 的 证 书 。 随 后 ，authenticationManager 用 
于 验证 当前 请 求 。AccountCredentials 则 是 尚未 实现 的 一 个 类 ， 对 此 ， 创 建 名 为 security 


的 新 数据 包 ， 并 将 AccountCredentials.kt 文件 添加 至 其 中 ， 如 下 所 示 : 
package com.example.messenger.api.security 
class AccountCredentials { 


lateinit var username: String 


lateinit var password: String 


} 


由 于 需要 对 用 户 进行 验证 ， 因 而 此 处 定义 了 username 和 password 变量 。 
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当 用 户 验证 成 功 后 ， 即 调用 SuccessfulAuthentication(0) 方 法 ， 对 应 任务 是 向 HTTP 响 
应 头 Authorization 中 添加 验证 标记 ， 实 际 的 添加 过 程 则 由 TokenAuthenticationService. 
addAuthentication0 完 成 。 下 面向 services 数据 包 中 加 入 该 服务 ， 如 下 所 示 : 


package com.example.messenger.api.services 

import io.jsonwebtoken.Jwts 

import io.jsonwebtoken.SignatureAlgorithm 

import 
org.springframework.security.authentication.UsernamePasswordAuthenticationT 
oken 

import org.springframework.security.core.Authentication 

import org.springframework.security.core.GrantedAuthority 


import javax.servlet.http.HttpServletRequest 
import javax.servlet.http.HttpServletResponse 
import java.util.Date 


import java.util.Collections.emptyList 


internal object TokenAuthenticationService { 
private val TOKEN EXPIRY: Long = 864000000 
private val SECRET = "$78gr43g7g8feb8we" 
private val TOKEN PREFIX = "Bearer" 
private val AUTHORIZATION HEADER_KEY = "Authorization" 


fun addAuthentication(res: HttpServletResponse, username: String) { 
val JWT = Jwts.builder() 
-setSubject (username) 
. setExpiration (Date (System.currentTimeMillis() + 
TOKEN EXPIRY) ) 
.signWith(SignatureAlgorithm.HS512, SECRET) 
- compact () 
res.addHeader (AUTHORIZATION HEADER KEY, "STOKEN PREFIX $JWT") 


fun getAuthentication(request: HttpServletRequest): Authentication? { 
val token = request.getHeader (AUTHORIZATION HEADER KEY) 
iff (token != null) { 


标记 的 解析 过 程 如 下 所 示 : 
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val user = Jwts.parser().setSigningKey (SECRET) 
-parseClaimsJws (token.replace(TOKEN PREFIX, "")) 
-body.subject 


if (user !- null) 
return UsernamePasswordAuthenticationToken(user, null, 
emptyList<GrantedAuthority>()) 
} 


return null 


} 


顾名思义 ，addAuthentication0 向 HTTP 响应 头 Authorization 中 加 入 验证 标记 ; 
getAuthentication0) 负 责 对 用 户 进行 验证 。 

下 面向 filters 数据 包 中 添加 JWTAuthenticationFilter。 对 此 ， 可 向 filters 数据 包 中 加 
入 JWTAuthenticationFilter 类 ， 如 下 所 示 : 


package com.example.messenger.api.filters 


import com.example.messenger.api.services.TokenAuthenticationService 
import org.springframework.security.core.context.SecurityContextHolder 
import org.springframework.web.filter.GenericFilterBean 

import javax.servlet.FilterChain 

import javax.servlet.ServletException 

import javax.servlet.ServletRequest 

import javax.servlet.ServletResponse 

import javax.servlet.http.HttpServletRequest 

import java.io.IOException 


class JWTAuthenticationFilter : GenericFilterBean() { 


(Throws (IOException::class, ServletException::class) 
override fun doFilter(request: ServletRequest, 
response: ServletResponse, 
filterChain: FilterChain) { 
val authentication - TokenAuthenticationService 
-getAuthentication (request as HttpServletRequest) 
SecurityContextHolder.getContext().authentication = authentication 


filterChain.doFilter(request, response) 
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每 次 请 求 /响应 作为 资源 请 求 传递 至 过 滤器 链 时 , JWTAuthenticationFilter 的 doFilter() 
函数 将 被 容器 调用 。 传 递 至 doFilter0 中 的 FilterChain 实例 使 得 过 滤器 将 请 求 和 响应 传递 
至 过 滤器 链 中 的 下 一 个 实体 中 。 

最 后 ， 像 以 往 一 样 ， 还 需要 实现 AppUserDetailsService 类 ， 并 将 该 类 置 于 项 目的 
services 包 中 ， 如 下 所 示 : 


package com.example.messenger.api.services 


import com.example.messenger.api.repositories.UserRepository 

import org.springframework.security.core.GrantedAuthority 

import org.springframework.security.core.authority.SimpleGrantedAuthority 
import org.springframework.security.core.userdetails.User 

import org.springframework.security.core.userdetails.UserDetails 
import org.springframework.security.core.userdetails.UserDetailsService 
import 
org.springframework.security.core.userdetails.UsernameNotFoundException 
import org.springframework.stereotype.Component 

import java.util.ArrayList 


GComponent 
class AppUserDetailsService(val userRepository: UserRepository) : 
UserDetailsService { 


@Throws (UsernameNotFoundException::class) 
override fun loadUserByUsername (username: String): UserDetails ( 
val user = userRepository.findByUsername (username) ?: 
throw UsernameNotFoundException("A user with the 
username $username doesn't exist") 
return User(user.username, user.password, 
ArrayList<GrantedAuthority>()) 


} 


对 于 传递 至 loadUsername(String) 函 数 中 的 用 户 名 ， 该 函数 尝试 加 载 与 其 匹配 的 
UserDetails。 如 果 不 存 在 此 类 用 户 ， 则 抛 出 UsernameNotFoundException. 

至 此 , 我 们 已 经 成 功 配 置 了 Spring Security。 下 面 准备 利用 控制 器 并 通过 RESTful 端 
点 展示 一 些 API 功能 。 

4. 通过 RESTful 端点 访问 服务 器 资源 

截至 目前 ， 我 们 已 经 创建 了 模型 、 组 件 、 服 务 以 及 服务 实现 ， 并 将 Spring Security 
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整合 至 消息 应 用 程序 中 ， 但 尚未 实现 外 部 客户 端 与 消息 API 之 间 的 通信 方式 。 下 面 将 构 
建 控制 器 类 ， 进 而 处 理 来 自 不 同 HTTP 请 求 路 径 的 请 求 。 与 往常 一 样 ， 首 先 需要 创建 一 
个 数据 包 ， 以 包含 即将 创建 的 控制 器 。 

这 里 ， 第 一 个 需要 实现 的 控制 器 是 UserController， 该 控制 器 将 与 用 户 资源 相关 的 
HTTP 请 求 映射 为 类 中 的 动作 ， 进 而 处 理 、 响 应 HITP 请 求 。 首 先 ， 需 要 一 个 端点 以 简化 
新 用 户 的 注册 。 随 后 ， 可 调用 这 一 动作 处 理 此 类 create 注册 请 求 。 下 列 代 码 表示 为 包含 
create 动作 的 UserController 代码 。 


package com.example.messenger.api.controllers 


import com.example.messenger.api.models.User 

import com.example.messenger.api.repositories.UserRepository 
import com.example.messenger.api.services.UserServiceImpl 
import org.springframework.http.ResponseEntity 

import org.springframework.validation.annotation.Validated 
import org.springframework.web.bind.annotation.* 

import javax.servlet.http.HttpServletRequest 


GRestController 
GRequestMapping ("/users") 
class UserController(val userService: UserServiceImpl, 
val userRepository: UserRepository) ( 


@PostMapping 
GRequestMapping ("/registrations") 


fun create (@Validated @RequestBody userDetails: User): 
ResponseEntity<User> { 
val user = userService.attemptRegistration(userDetails) 
return ResponseEntity.ok (user) 
} 
} 
控制 器 类 利用 @RestController #1 @RequestMapping 进行 标注 。 其 中 ， 注 解 
@RestController 指定 某 个 类 为 REST 控制 器 ;而 与 UserController 一 同 使 用 的 
@RequestMapping， 则 将 全 部 请 求 ( 以 /users 路 径 开 始 ) 映射 至 UserController。 
create 函数 利用 @PostMapping 和 @RequestMapping("/registrations") 加 以 标注 。 这 两 个 
注解 的 组 合 将 全 部 POST 请 求 ( 包 含 /users/registrations 路 径 ) 映射 至 create 函数 。 通 过 
@Validated 和 @RequestBody 标注 的 User 实例 将 被 传递 至 create 中 。@RequestBody 将 
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POST 请 求 体 中 发 送 的 JSON 值 绑 定 到 userDetails 中 。@Validated 确保 ISON 参数 将 被 验 
证 。 在 建立 了 端点 并 成 功 运行 后 ， 下 面 将 对 其 进行 测试 。 启 动 应 用 程序 并 导航 至 终端 窗 
， 使 用 CURL 向 Messenger API 发 送 请 求 ， 如 下 所 示 : 


curl -H "Content-Type: application/json" -X POST -d 


'{"username":"kevin.stacey", 
"phoneNumber" : "5472457893", 
"password" :"Hello123"}' 

http: //localhost: 8080/users/registrations 


服务 器 将 创建 一 个 用 户 并 发 送 一 个 响应 ， 如 下 所 示 : 
{ 


"username": "kevin.stacey", 

"phoneNumber": "5472457893", 

"password":"XXX XXXX XXX", 

"status":"available", 

"accountStatus":"activated", 

"id":6,"createdAt":1508579448634 
} 


一 切 均 工作 良好 ， 但 是 我 们 可 以 看 到 ，HTTP 响应 中 包含 了 许多 不 需要 的 值 ， 例 如 
password 和 accountStatus 响应 参数 。 除 此 之 外 ， 我 们 还 希望 createdAt 中 包含 一 个 人 类 可 
读 的 日 期 。 下 面 将 使 用 装配 器 和 值 对 象 来 完成 所 有 这 些 工作 。 

首先 将 定义 一 个 值 对 象 ， 其 中 包含 了 用 户 数 据 ， 并 以 相应 的 格式 传递 至 客户 端 。 相 
应 地 ， 可 创建 helpers.objects 数据 包 ， 其 中 设置 了 ValueObjects.kt 文件 ， 如 下 所 示 : 


package com.example.messenger.api.helpers.objects 


data class UserVO( 
val id: Long, 
val username: String, 
val phoneNumber: String, 
val status: String, 
val createdAt: String 

) 


不 难 发 现 ，UserVO 表示 为 一 个 数据 类 ， 并 对 传递 至 用 户 的 信息 进行 建 模 。 相 应 地 ， 
可 针对 后 续 操 作 中 的 其 他 响应 添加 值 对 象 ， 以 避免 再 次 返回 至 当前 文件 中 ， 如 下 所 示 : 


package com.example.messenger.api.helpers.objects 
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data class UserVO( 
val id: Long, 


val username: String, 
val phoneNumber: String, 


val status: String, 


val createdAt: String 


data class UserListVO( 
val users: List«UserVO» 


data class MessageVO( 
val id: Long, 
val senderId: Long?, 
val recipientId: Long?, 
val conversationId: Long?, 
val body: String?, 
val createdAt: String 


data class ConversationVO( 
val conversationId: Long, 
val secondPartyUsername: String, 
val messages: ArrayList<MessageVO> 


data class ConversationListVO( 
val conversations: List<ConversationVO> 


在 所 请 求 的 值 对 象 设置 完毕 后 ， 下 面 针对 UserVO 创建 一 个 装配 器 。 这 里 ， 装 配器 可 


简单 地 表示 为 一 个 组 件 ， 并 装配 所 需 的 对 象 值 。 当 创建 UserAssembler 时 ， 该 装配 器 将 被 


调用 。 考 虑 到 装配 器 表示 为 一 个 组 件 ， 因 而 其 隶属 于 components 数据 包 中 ， 如 下 所 示 : 


package com.example.messenger.api.components 


import 
import 
import 
import 


com.example.messenger.api.helpers.objects.UserListVO 
com.example.messenger.api.helpers.objects.UserVO 
com.example.messenger.api.models.User 
org.springframework.stereotype.Component 
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GComponent 
class UserAssembler { 


fun toUserVO(user: User): UserVO ( 
return UserVO(user.id, user.username, user.phoneNumber, 
user.status, user.createdAt.toString()) 


fun toUserListVO(users: List<User>): UserListVO { 
val userVOList = users.map { toUserVO(it) } 
return UserListVO (userVOList) 


} 

装配 器 定义 了 单一 函数 toUser VOQ, 并 接收 User 作为 参数 ,同时 返回 对 应 的 User VO. 
类 似 地 ，toUserListVOO 接 收 一 个 User 实例 列表 ， 并 返回 对 应 的 UserListVO。 

下 面 编辑 create 端点 ， 并 使 用 UserAssembler 和 UserVO， 如 下 所 示 : 


package com.example.messenger.api.controllers 


import com.example.messenger.api.components.UserAssembler 
import com.example.messenger.api.helpers.objects.UserVO 
import com.example.messenger.api.models.User 

import com.example.messenger.api.repositories.UserRepository 
import com.example.messenger.api.services.UserServiceImpl 
import org.springframework.http.ResponseEntity 

import org.springframework.validation.annotation.Validated 
import org.springframework.web.bind.annotation.* 

import javax.servlet.http.HttpServletRequest 


GRestController 
GRequestMapping ("/users") 
class UserController(val userService: UserServiceImpl, 
val userAssembler: UserAssembler, 
val userRepository: UserRepository) { 


@PostMapping 
GRequestMapping ("/registrations") 
fun create (@Validated @RequestBody userDetails: User): 
ResponseEntity«UserVO» { 
val user = userService.attemptRegistration (userDetails) 
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return ResponseEntity.ok(userAssembler.toUserVO (user)) 


lim 


EMIRS de. FRA STAIR AEM S User。 这 里 ， 我 们 将 从 API 中 得 到 更 
为 适宜 的 响应 结果 ， 如 下 所 示 : 


ob gis 

"username":"kevin.stacey", 

"phoneNumber":"5472457893", 

"status":"available", 

"createdAt":"Sat Oct 21 11:11:36 WAT 2017" 
} 


下 面 为 Messenger Android 应 用 程序 创建 所 有 必要 的 端点 ， 以 结束 端点 创建 过 程 。 首 
先 ， 可 添加 端点 显示 用 户 的 详细 信息 、 列 出 所 有 用 户 、 获 取 当 前 用 户 的 详细 信息 ， 并 将 
User 的 状态 更 新 为 UserController， 如 下 所 示 : 


package com.example.messenger.api.controllers 


import com.example.messenger.api.components.UserAssembler 
import com.example.messenger.api.helpers.objects.UserListVO 
import com.example.messenger.api.helpers.objects.UserVO 
import com.example.messenger.api.models.User 

import com.example.messenger.api.repositories.UserRepository 
import com.example.messenger.api.services.UserServiceImpl 
import org.springframework.http.ResponseEntity 

import org.springframework.validation.annotation.Validated 
import org.springframework.web.bind.annotation.* 

import javax.servlet.http.HttpServletRequest 


GRestController 
GRequestMapping ("/users") 
class UserController(val userService: UserServiceImpl, 
val userAssembler: UserAssembler, 
val userRepository: UserRepository) { 


@PostMapping 

@RequestMapping ("/registrations") 

fun create (@Validated @RequestBody userDetails: User): 
ResponseEntity<Uservo> { 
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val user = userService.attemptRegistration (userDetails) 


return ResponseEntity.ok(userAssembler.toUserVO (user)) 


@GetMapping 
@RequestMapping("/{user id}") 
fun show(8PathVariable("user id") userId: Long): 
ResponseEntity<Uservo> { 
val user = userService.retrieveUserData (userId) 
return ResponseEntity.ok(userAssembler.toUserVO (user) ) 


@GetMapping 
GRequestMapping ("/details") 
fun echoDetails(request: HttpServletRequest): . 
ResponseEntity«UserVO»( 
val user - userRepository.findByUsername 
(request.userPrincipal.name) as User 
return ResponseEntity.ok(userAssembler.toUserVO (user)) 


@GetMapping 
fun index(request: HttpServletRequest): ResponseEntity<UserListVo> { 
val user - userRepository.findByUsername 
(request.userPrincipal.name) as User 
val users - userService.listUsers (user) 


return ResponseEntity.ok(userAssembler.toUserListVO (users)) 


@PutMapping 
fun update (@RequestBody updateDetails: User, 
request: HttpServletRequest): ResponseEntity<Uservo> { 
val currentUser = userRepository.findByUsername 
(request .userPrincipal.name) 
userService.updateUserStatus (currentUser as User, updateDetails) 
return ResponseEntity.ok(userAssembler.toUserVO (currentUser) ) 


下 面 创建 控制 器 并 处 理 消 息 资源 和 会 话 资源 , 即 MessageController 和 ConversationController。 


* 168 * Kotlin 语言 实例 精 解 


在 构建 控制 器 之 前 ， 将 会 使 用 到 装配 器 ， 进 而 装配 源 自 JPA 实体 中 的 值 对 象 。 相 应 地 ， 
MessageAssembler 的 定义 如 下 所 示 : 


package com.example.messenger.api.components 


import com.example.messenger.api.helpers.objects.MessageVO 
import com.example.messenger.api.models.Message 
import org.springframework.stereotype.Component 


GComponent 
class MessageAssembler { 
fun toMessageVO (message: Message): MessageVO { 
return MessageVO (message.id, message.sender?.id, 
message.recipient?.id, message.conversation?.id, 
message.body, message.createdAt.toString()) 


} 
接 下 来 ， 将 创建 ConversationAssembler， 如 下 所 示 


package com.example.messenger.api.components 


import com.example.messenger.api.helpers.objects.ConversationListVO 
import com.example.messenger.api.helpers.objects.ConversationVO 
import com.example.messenger.api.helpers.objects.MessageVO 

import com.example.messenger.api.models.Conversation 

import com.example.messenger.api.services.ConversationServiceImpl 
import org.springframework.stereotype.Component 


GComponent 

class ConversationAssembler(val conversationService: 
ConversationServiceImpl, 
val messageAssembler: MessageAssembler) { 


fun toConversationVO (conversation: Conversation, userId: Long): 
ConversationVO ( 
val conversationMessages: ArrayList<MessageVO> = ArrayList() 
conversation.messages.mapTo(conversationMessages) { 


messageAssembler.toMessageVO (it) 
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return ConversationVO(conversation.id, conversationService 
.nameSecondParty (conversation, userId), 


conversationMessages) 


fun toConversationListVO (conversations: ArrayList<Conversation>, 
userId: Long): ConversationListVO { 
val conversationVOList - conversations.map ( toConversationVO(it, 
userId) } 
return ConversationListVO(conversationVOList) 


} 


对 于 MessageController 和 ConversationController 来 说 ， 一 切 均 已 就 绪 。 对 于 当前 相 
对 简单 的 Messenger 应 用 程序 ， 只 需 为 MessageController 提供 一 个 消息 创建 动作 。 下 列 
代码 展示 了 基于 消息 创建 动作 的 MessageController， 即 create。 


package com.example.messenger.api.controllers 


import com.example.messenger.api.components.MessageAssembler 
import com.example.messenger.api.helpers.objects.MessageVO 
import com.example.messenger.api.models.User 

import com.example.messenger.api.repositories.UserRepository 
import com.example.messenger.api.services.MessageServiceImpl 
import org.springframework.http.ResponseEntity 

import org.springframework.web.bind.annotation.* 

import javax.servlet.http.HttpServletRequest 


GRestController 

GRequestMapping ("/messages") 

class MessageController(val messageService: MessageServiceImpl, 
val userRepository: UserRepository, 
val messageAssembler: MessageAssembler) ( 


@PostMapping 
fun create (@RequestBody messageDetails: MessageRequest, 
request: HttpServletRequest): ResponseEntity«MessageVO» { 
val principal - request.userPrincipal 
val sender = userRepository.findByUsername (principal.name) as User 


val message = messageService.sendMessage (sender, 
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messageDetails.recipientId, messageDetails.message) 


return ResponseEntity.ok(messageAssembler.toMessageVO (message) ) 


data class MessageRequest (val recipientId: Long, val message: String) 


} 


最 后 ， 还 需要 生成 ConversationController， 且 仅 需 要 使 用 到 两 个 端点 。 其 中 ， 一 个 端 
点 列 出 用 户 的 所 有 活动 会 话 ， 另 一 个 端点 用 于 获取 会 话 线程 中 的 消息 。 这 一 类 端点 分 别 
通过 list0 和 show0 动 作 被 创建 。ConversationController 类 定义 如 下 所 示 : 


package com.example.messenger.api.controllers 


import com.example.messenger.api.components.ConversationAssembler 
import com.example.messenger.api.helpers.objects.ConversationListVO 
import com.example.messenger.api.helpers.objects.ConversationVO 
import com.example.messenger.api.models.User 

import com.example.messenger.api.repositories.UserRepository 

import com.example.messenger.api.services.ConversationServiceImpl 
import org.springframework.http.ResponseEntity 

import org.springframework.web.bind.annotation.* 

import javax.servlet.http.HttpServletRequest 


GRestController 

@RequestMapping ("/conversations") 

class ConversationController( 
val conversationService: ConversationServiceImpl, 
val conversationAssembler: ConversationAssembler, 
val userRepository: UserRepository 


@GetMapping 
fun list (request: HttpServletRequest): ResponseEntity«ConversationListVO» 


val user = userRepository.findByUsername (request 
-userPrincipal.name) as User 
val conversations - conversationService.listUserConversations 
(user.id) 
return ResponseEntity.ok(conversationAssembler 


-toConversationListVO (conversations, user.id)) 
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@GetMapping 
@RequestMapping("/{conversation id}") 
fun show (@PathVariable (name = "conversation id") conversationId: Long, 
request: HttpServletRequest): ResponseEntity«ConversationVO» { 
val user = userRepository.findByUsername (request 
-userPrincipal.name) as User 
val conversationThread - conversationService.retrieveThread 
(conversationId) 
return ResponseEntity.ok(conversationAssembler 
-toConversationVO(conversationThread, user.id)) 


忆 一 下 ， 用 户 包含 了 相应 的 账户 状态 ， 并 有 可 能 注销 该 账户 。 此 时 ， 作 为 API 的 
定义 者 ,我 们 并 不 希望 注销 用 户 使 用 当前 平台 。 因 此 ， 应 避免 此 类 用 户 与 API 进行 交互 。 
对 此 ， 存 在 多 种 方式 可 实现 这 一 功能 。 当 前 示例 将 使 用 拦截 器 截取 HTTP 请 求 ， 并 在 其 
继续 沿 着 请 求 链 下 行 之 前 ， 执 行 一 项 或 多 项 操作 。 类 似 于 装配 器 ， 拦 截 器 也 表示 为 一 类 
组 件 。 相 应 地 ， 可 调用 拦截 器 检测 账户 AccountValidityInterceptor 的 有 效 性 。 下 列 代 码 定 
义 了 拦截 器 类 〈 位 于 components 包 中 ) 。 


package com.example.messenger.api.components 


回 


1| 


import com.example.messenger.api.exceptions.UserDeactivatedException 
import com.example.messenger.api.models.User 

import com.example.messenger.api.repositories.UserRepository 

import org.springframework.stereotype.Component 

import org.springframework.web.servlet.handler.HandlerInterceptorAdapter 
import java.security.Principal 

import javax.servlet.http.HttpServletRequest 

import javax.servlet.http.HttpServletResponse 


@Component 
class AccountValidityInterceptor (val userRepository: 
UserRepository) : HandlerInterceptorAdapter() { 


@Throws (UserDeactivatedException::class) 


override fun preHandle(request: HttpServletRequest, 
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response: HttpServletResponse, handler: Any?): Boolean { 


val principal: Principal? = request.userPrincipal 
if (principal != null) { 
val user = userRepository.findByUsername (principal.name) 
as User 
if (user.accountStatus -- "deactivated") ( 


throw UserDeactivatedException("The account of this user has 
been deactivated.") 


} 
return super.preHandle(request, response, handler) 
} 
} 


AccountValidityInterceptor 2578 * SHAH preHandle0 函 数 ， 在 将 请 求 路 由 至 控制 
器 动作 之 前 ,该 函数 将 被 调用 并 执行 某 些 操作 。 在 生成 拦截 器 后 , 该 拦截 器 需要 通过 Spring 
应 用 程序 注册 ， 这 一 配置 操作 可 通过 WebMvcConfigurer 完成 。 接 下 来 ， 将 AppConfig X: 
件 添加 至 项 目的 config 数据 包 中 ， 并 在 该 文件 中 输入 下 列 代码 : 


package com.example.messenger.api.config 


import com.example.messenger.api.components.AccountValidityInterceptor 
import org.springframework.beans.factory.annotation.Autowired 

import org.springframework.context.annotation.Configuration 

import 
org.springframework.web.servlet.config.annotation.InterceptorRegistry 
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer 


GConfiguration 
class AppConfig : WebMvcConfigurer ( 


@Autowired 
lateinit var accountValidityInterceptor: AccountValidityInterceptor 


override fun addInterceptors(registry: InterceptorRegistry) { 
registry.addInterceptor (accountValidityInterceptor) 


super.addInterceptors (registry) 
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AppConfig 表示 为 WebMvcConfigurer 的 子 类 ， 并 覆 写 了 其 超 类 中 的 addInterceptor 
(InterceptorRegistry) 函 数 。 通 过 registry.addInterceptor()， 可 将 accountValidityInterceptor 
添加 至 注册 表 中 。 

至 此 , 我 们 完成 了 向 Messenger Android 应 用 程序 提供 Web 资源 所 需 的 全 部 代码 ， 下 
面 将 代码 部 署 至 远程 服务 器 上 。 


43 将 Messenger API 部 署 至 AWS 上 


将 Spring Boot 应 用 程序 部 署 至 AWS 的 过 程 十 分 简单 ,甚至 可 以 在 10 分 钟 之 内 完成 。 
本 节 介 绍 如 何 将 基于 Spring 的 应 用 程序 部 署 至 AWS 上 。 在 部 署 应 用 程序 之 前 ， 首 先 配 
置 应 用 程序 需要 连接 的 、AWS 上 的 PostgreSQL 数据 库 。 


4.3.1 配置 AWS 上 的 PostgreSQL 


首先 需要 创建 AWS 账户 ， 对 此 ， 读 者 可 访问 https://portal.aws.amazon.com/billing/ 

signup#/start。 待 注册 完毕 后 , 可 登录 AWS 并 访问 Amazon Relational Database Service(RDS) 

(或 者 在 导航 栏 中 单 击 Services | Database | RDS) ， 如 图 4.10 所 示 。 在 RDS 窗口 中 ， 单 
击 Get Started Now 按钮 。 


Amazon RDS x 


= 
= © 
Clusters 
Snapshots 


m Amazon Relational Database Service 
pedis ‘Amazon Relational Database Service (Amazon RDS) makes it easy to set 


h 


Subnet groups 
Parameter groups 
Option groups 
Events 

Event subscriptions 


Notifications 


图 4.10 Amazon Relational Database Service 窗口 
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浏览 Launch DB instance Web 页 面 ， 读 者 需要 选取 与 DB 配置 相关 的 选项 。 这 里 ， 选 
择 PostgreSQL 作为 可 用 的 DB 引擎 ， 如 图 4.11 所 示 。 


三 Specify DB details. Engine options 


Step 3 x 
Configure advanced O Amazon Aurora D MySQL O MariaDB 


settings 
Amazon 
Aurora 


[© Posgresau 7 J fe Oracle O Microsoft SQL Server 
«q ORACLE J* SOL server 


PostgreSQL 

PostgreSQL is a powerful, open-source object-relational database system with a strong reputation of reliability, 
stability, and correctness. 

* High reliability and stability in a variety of workloads. 

* Advanced features to perform in high-volume environments. 

* Vibrant open-source community that releases new features multiple times per year. 

* Supports multiple extensions that add even more functionality to the database. 

* The most Oracle-compatible open-source database. 


Only enable options eligible for RDS Free Usage Tier info Cancel | Next | 


图 4.11 选择 PostgreSQL 作为 可 用 的 DB 引擎 


这 里 ， 应 确保 选中 Only enable options eligible for RDS Free Usage Tier info 复 选 框 。 
单 击 Next 按钮 将 转 至 下 一 个 页 面 。 其 中 ， 应 保留 实例 规范 的 默认 设置 ， 并 输入 必要 的 
DB 设置 , 例如 DB 实例 名 称 以 及 主 密码 。 当 然 , 读者 也 可 以 选择 其 他 名 称 。 无 论 如 何 ， 
应 确保 谨慎 处 理 所 输 入 的 内 容 。 随 后 可 进入 如 图 4.12 所 示 的 Configure advanced settings 
页 面 。 

在 Network & Security 部 分 中 ， 确 保 启用 了 公共 访问 ， 并 选取 VPC Security Groups 
下 方 的 Create new VPC security group 选项 。 随 后 ， 将 页 面 滚 动 至 Database options 部 分 ， 
并 输入 DB 名 称 。 再 次 强调 ， 这 里 使 用 了 MessengerDB 作为 DB 名 称 。 其 他 选项 则 保留 
默认 设置 ， 单 击 页 面 下 方 的 Launch DB instance 按钮 。 

至 此 ，DB 实例 通过 AWS 创建 。 这 一 创建 过 程 可 能 会 占用 10 分 钟 左右 的 时 间 ， 读 
者 可 在 此 期 间 稍 做 敬 息 。 

随后 ， 单 击 View DB instance details 按钮 ， 接 下 来 所 显示 的 页 面包 含 了 DB 部 署 实例 
的 详细 信息 。 将 页 面 滚动 至 Connect 部 分 ， 并 查看 DB 实例 的 连接 信息 ， 如 图 4.13 所 示 。 


第 4 章 设计 并 实现 Messenger 后 端 应 用 程序 *175* 


RDS > Launch DB instance 


Your DB instance is being created. 
Note: Your instance may take a few minutes to launch. 


Connecting to your DB instance 


Once Amazon RDS finishes provisioning your DB instance, you can use a SQL client application or utility to connect to 
the instance, 
Learn about connecting to your DB instance 


wen SE 


@ Feedback @ English (US) 


图 4.12 Configure advanced settings 页 面 


Connect 
Endpoint Publicly accessible 
messenger-api.c4cktbbmcjBs.us-east- Yes 


1.rds.amazonaws.com 
Master username 


5432 


Security group (1) 


| Q Fitter security group meas 


Security group Type Rule 


rds-launch-wizard CIDR/IP [zs 


图 4.13 查看 DB 实例 的 连接 信息 

通过 上 述 信 息 ， 可 成 功 地 连接 至 PostgreSQL DB 实例 上 的 MessengerDB 。 当 启用 

messenger-api 并 连接 至 MessengerDB 时 ， 需 要 编辑 application.properties 文件 中 的 

spring.datasource.url、spring.datasource.username 以 及 spring.datasource.password 属性 。 随 
后 ，application.properties 中 的 对 应 内 容 如 下 所 示 : 


2176" 
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spring.jpa.generate-ddl-true 


spring.jpa.hibernate.ddl-auto-create-drop 


spring.datasource.url- 


jdbc:postgresql://«endpoint»/MessengerDB 


spring.datasource.username-«master username» 


spring.datasource.password=<password> 


最 后 将 向 Amazon EC2 实例 部 署 Messenger API. 


4.3.2 向 Amazon Elastic Beanstalk 部 署 Messenger API 


将 应 用 程序 部 署 至 AWS 上 同样 十 分 简单 。 在 AWS 控制 台中 ， 选 择 Services | Compute | 
Elastic Beanstalk 命令 。 在 Elastic Beanstalk Management Console 中 ， 单 击 Create New 
Application 按钮 。 当 显示 Create Application 页 面 时 ， 读 者 将 被 提示 输入 应 用 程序 名 称 和 
描述 。 此 处 ， 可 将 其 命名 为 messenger-api， 随 后 转 至 如 图 4.14 所 示 的 画面 ， 并 提示 创建 


We're testing a new design for the environment creation wizard. Opt in now to try it and letus know what you think! 


一 个 FÈ A 
个 新 的 开发 环境 。 
A. Elastic Beanstak 
@ Tr the new design 
‘Application Info. — i 
| sew = lew Environment 

Web Server Environment 
balancing, auto scaling environment. Learn more 
Worker Environment" 
balancing, auto scaling environment. Learn more 

@ Feedback @ Enalish (US) 


AWS Elastic Beanstalk has two types of environment tiers to support different types of web applications. Web servers are standard applications that listen for and 
then process HTTP requests, typically over port 80. Workers are specialized applications that have a background processing task that listens for messages on an 
Amazon SOS queue. Worker applications post those messages to your application by using HTTP. 


nme Eun Bort unb aaraa h eihar de tan 


u"————————— 上 


图 4.14 创建 一 个 新 的 开发 环境 


其 中 ,读者 可 构建 一 个 Web 服 务 器 环境 ,并 于 随后 配置 环境 类 型 ,这 里 ,可 选取 Tomcat 


预定 义 配 置 环境 ， 并 将 当前 环 
待 设置 完毕 后 ， 将 转 至 如 


境 类 型 调整 为 Single instance， 如 图 4.15 所 示 。 


图 4.16 所 示 画 面 ， 此 时 需要 针对 当前 应 用 程序 选取 相关 来 


源 。 此 处 可 选中 Upload your own. 
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A Elastic Beanstak Create New Environment 
e Try the new design 
We're testing a new design for the environment creation wizard. Opt in now to try it and let us know what you think! 
Application Info . 
New Er e" Environment Type 
| Environment Type 
Application Version ‘Choose the platform and type of environment to launch. 
Environment Info. Predefined configuration: | Tomcat +) Looking for a different platform? Lat us know. 
Additional Resources 
Conf Dele AWS Elastic Beanstalk wil create an environment running Tomcat 8 Java 8 on 64bit Amazon Linux 2017.03 v2.6.5. Change platform 
Environment Tags 
Pop Environment type: | Single instance. Learn more 
Review Information. 
cen (Previous| SE 


图 4.15 构建 一 个 Web 服务 器 环境 


EE 


e Try the new design 
‘We're testing a new design for the environment creation wizard. Opt in now to try it and let us know what you think! 


Application Info. 
ow Bocoent Application Version 
Environment Type. 
| Application Version. Select a source for your application version. 
Environment Into Source: Sample application. 
iesu © Upload your own (Learn more) 
Contain Delle Choose rie Messenger-a...NAPSHOT jar 
Environment Tags 
Permissions E: us. : 
i [ | es https://53 amazonaws.convsaBucket/soKey) 
Uploading application version... 


Cancel Previous MITES 


图 4.16 针对 当前 应 用 程序 选取 相关 来 源 


当前 需要 创建 相应 的 项 目 压缩 包 并 予以 上 传 .通过 Maven, 可 将 Messenger API 打包 ， 
如 图 4.17 所 示 。 
单 击 项 目 IDE 窗口 右 侧 的 Maven Projects 按钮 ， 并 选择 messenger-api | Lifecycle | 
package。 相 应 地 ， 项 目 压 缩 包 Gar) 将 被 打包 ， 并 存储 于 项 目的 目标 目录 中 。 
随后 返回 至 AWS， 并 选取 该 jar 文件 作为 上 传 源 文件 。 其 他 属性 则 保持 默认 选项 ， 
并 单 击 Next 按钮 。 在 打包 jar 文件 上 传 过 程 中 ， 读 者 可 能 需要 等 待 少许 时 间 。 待 上 传 完 
毕 后 ， 新 窗口 中 将 显示 当前 环境 信息 。 在 随后 的 几 个 窗口 中 ， 读 者 可 简单 地 单 击 Next 按 
钮 ， 直 至 到 达 Configuration Details 窗口 。 其 中 ， 需 要 将 实例 类 型 修改 为 t2.micro。 
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sloaloud uane 


E] 


package 


图 4.17 通过 Maven， 可 将 Messenger API 打包 


在 Review Information 窗口 中 ， 将 页 面 滚动 至 Environment Info， 如 图 4.18 所 示 。 
Environment Info 


Environment name messengerApi-env 


Environment URL — http//messengerapi-env.us-east-1.elasticbeanstalk.com 


Description REST API for the Messenger app. 


图 4.18 Environment Info 窗口 
注意 ， 当 前 环境 URL 将 发 生变 化 ， 读 者 应 对 此 留意 ， 稍 后 将 会 使 用 到 此 类 信息 。 随 
后 ， 将 Web 页 面 滚动 至 下 方 ， 并 单 击 Launch 按钮 。 此 时 ，Elastic Beanstalk 将 启用 当前 


新 环境 。 
至 此 ，messenger-api 已 经 成 功 地 部 署 至 AWS 中 。 


44 本 章 小 结 


本 章 介 绍 了 如 何 利 用 Kotlin 构建 Spring Boot REST 应 用 程序 编程 接口 。 其 间 ， 我 们 
学 习 了 系统 设计 的 基本 知识 , 通过 状态 图 显示 了 Messenger API 系统 的 行为 , 同时 还 了 解 
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到 状态 图 中 新 型 的 拦截 方式 。 随 后 ， 我 们 还 进一步 构建 了 E-R 图 ， 并 以 图 形 方式 详细 描 
述 了 系统 实体 及 其 关系 。 

此 外 ， 本 章 还 讨论 了 如 何在 本 地 机 器 上 配置 PostgreSQL， 并 创建 新 的 PosteresQL 数 
据 库 、 通 过 Spring Boot 2.0 构建 微服 务 、 将 微服 务 连接 至 数据 库 ， 并 利用 Spring Data 与 
数据 库 中 的 数据 进行 交互 。 

除 此 之 外 ， 本 章 还 利用 Spring Security 和 JSON Web Tokens (JWTs)Sz3 Y RESTful 
Spring Boot Web 应 用 程序 的 安全 性 。 其 中 生成 了 自 定 义 Spring Security 配置 ， 并 借助 于 
JWTs 实现 了 用 户 验证 ， 同 时 针对 验证 处 理 创 建 了 自 定义 过 滤器 。 最 后 ， 本 章 还 探讨 了 如 
何 向 AWS 部 署 Spring Boot 应 用 程序 。 

第 5 章 将 进一步 完善 Android Messenger 应 用 程序 ， 并 深入 讨论 Kotlin 方面 的 知识 。 
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第 4 章 通过 设计 和 实现 REST 应 用 程序 编程 接口 的 方式 (客户 端 Messenger 应 用 程序 
将 与 其 进行 通信 ) 开始 构建 Messenger 应 用 程序 。 在 实现 后 端 API 的 过 程 中 ， 涉 及 了 大 
EAR, 包括 与 Spring Boot 的 协同 工作 方式 、RESTful 应 用 程序 编程 接口 及 其 工作 方式 、 
基于 PostgreSQL 的 数据 库 搭建 ， 以 及 向 AWS 部 署 Spring Boot Web 应 用 程序 等 。 

本 章 将 进一步 揭秘 应 用 程序 开发 之 旅 ， 实 现 Android Messenger 应 用 程序 ， 并 将 其 与 
RESTful API 进行 整合 。 在 Messenger Android App 开发 过 程 中 ， 将 会 涉及 大 量 的 新 鲜 话 
题 ， 其 中 包括 : 

O ib MVP Android 应 用 程序 。 

O 基于 HTTP 的 服务 器 通信 。 

口 ” 响 应 式 编程 。 

O ”在 Android App 中 使 用 基于 令 牌 的 身份 验证 。 

本 章 将 会 展示 Kotlin 语言 在 Android 应 用 程序 开发 领域 中 强大 的 功能 ， 并 深入 分 析 
Messenger App 的 开发 细节 内 容 。 


5.1 JFX Messenger App 


首先 需要 针对 应 用 程序 构建 新 的 Android Studio 项 目 ， 并 将 其 命名 为 Messenger, Xf 
应 的 包 名 为 com.example.messenger。 在 项 目 构建 过 程 中 ， 当 提示 创建 新 的 启动 程序 活动 
时 ， 可 将 对 应 活动 命名 为 LoginActivity， 并 生成 一 个 空 活动 。 


5.1.1 纳入 项 目 依赖 关系 


本 章 将 使 用 大 量 的 外 部 应 用 程序 依赖 关系 。 因 此 ， 需 要 将 其 纳入 当前 项 目 中 。 打 开 
build.gradle 模块 文件 ， 并 向 其 添加 下 列 依赖 关系 : 


dependencies { 
implementation fileTree(dir: 'libs', include: ['*.jar']) 
implementation "org.jetbrains.kotlin:kotlin-stdlib-jre7 
:$kotlin version" 
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implementation 'com.android.support:appcompat-v7:26.1.0"' 
implementation 'com.android.support.constraint:constraint-layout:1.0.2" 
implementation 'com.android.support:recyclerview-v7:26.1.0" 
implementation 'com.android.support:design:26.1.0' 


implementation "android.arch.persistence.room:runtime:1.0.0-alpha9-1" 

implementation "android.arch.persistence.room:rxjava2:1.0.0-alpha9-1" 

implementation 'com.android.support:support-v4:26.1.0" 

implementation 'com.android.support:support-vector-drawable:26.1.0' 

annotationProcessor "android.arch.persistence.room:compiler 
:1.0.0-alpha9-1" 


implementation "com.squareup.retrofit2:retrofit:2.3.0" 
implementation "com.squareup.retrofit2:adapter-rxjava2:2.3.0" 
implementation "com.squareup.retrofit2:converter-gson:2.3.0" 
implementation "io.reactivex.rxjava2:rxandroid:2.0.1" 


implementation 'com.github.stfalcon:chatkit:0.2.2" 


testImplementation 'junit:junit:4.12' 

androidTestImplementation 'com.android.support.test:runner:1.0.1"' 

androidTestImplementation 'com.android.support.test.espresso 
:espresso-core:3.0.1' 


} 


此 处 ， 应 确保 Android 支持 库 版 本 间 不 存在 任何 冲突 。 下 面 调整 build.gradle 项 目 文 
件 ， 并 包含 jcenter、Google 存储 库 以 及 Android 构建 工具 依赖 关系 ， 如 下 所 示 : 


buildscript ( 
ext.kotlin version - '1.1.4-3' 
repositories ( 
google () 
jcenter() 
} 
dependencies { 
classpath 'com.android.tools.build:gradle:3.0.0-alpha9" 
classpath "org. jetbrains.kotlin:kotlin-gradle-plugin:$kotlin version" 


} 


allprojects { 
repositories { 
google () 
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hi 
将 


jcenter() 


task clean(type: Delete) ( 


delete rootProject.buildDir 


} 


本 章 稍 后 还 将 对 依赖 关系 所 添加 的 内 容 再 次 予以 分 析 。 
5.1.2 开发 登录 UI 


当 项 目 创建 完毕 后 ， 即 可 构建 新 的 数据 包 ， 并 在 com.example.messenger 应 用 程序 源 
数据 包 中 将 其 命名 为 ui。 该 包 将 加 载 所 有 与 用 户 界面 相关 的 类 和 Android 应 用 程序 逻辑 。 
下 面 生成 一 个 包含 ui 的 login 包 。 相信 读者 已 经 猪 到 , 该 包 将 加 载 与 用 户 登 录 处 理 相关 的 
类 和 逻辑 。 接 下 来 , 可 将 LoginActivity 移 至 login 包 中 , 并 针对 登录 活动 创建 相应 的 布局 。 

在 activity login.xml 布局 源 文件 中 ， 输 入 下 列 内 容 


<?xml version-"1.0" encoding-"utf-8"?» 

<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
xmlns:tools-"http://schemas.android.com/tools" 
android:layout width-"match parent" 
android:layout height-"match parent" 
tools:context-".ui.login.LoginActivity" 
android:orientation-"vertical" 
android:paddingTop-"32dp" 
android:paddingBottom-"Gdimen/default margin" 
android:paddingStart="@dimen/default padding" 
android:paddingEnd="@dimen/default padding" 
android:gravity-"center horizontal"> 


<EditText 


android: 
android: 
android: 
android: 
android: 


<EditText 


android: 


android 
android 
android 


id="@+id/et_username" 

layout width-"match parent" 
layout height-"wrap content" 
inputType-"text" 
hint="@string/username"/> 


id="@+id/et_password" 


:layout width-"match parent" 
:layout height-"wrap content" 
:layout marginTop-"8dimen/default margin" 
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android:inputType-"textPassword" 
android:hint="@string/password"/> 

<Button 
android: id="@t+tid/btn_login" 
android: layout_width="wrap content" 
android:layout height="wrap content" 
android:layout marginTop="@dimen/default margin" 
android: text="@string/login"/> 

<Button 
android: id="@+id/btn_sign_up" 
android: layout_width="wrap_ content" 
android: layout_height="wrap_ content" 
android: layout marginTop="@dimen/default margin" 
android: background="@android:color/transparent" 
android:text="@string/sign up solicitation"/> 

<ProgressBar 
android: id="@+id/progress_ bar" 
android: layout_width="wrap_ content" 
android:layout height="wrap content" 
android: visibility="gone"/> 

</LinearLayout> 


此 处 使 用 了 字符 串 和 尺寸 资源 ， 这 一 类 资源 尚未 在 .xml 文件 中 创建 ， 因 而 须 对 其 予 
以 添加 。 除 此 之 外 ， 还 应 该 加 入 后 续 应 用 程序 开发 阶段 所 需 的 各 种 资源 ， 从 而 避免 在 程 
序 和 资源 文件 之 间 往 复 跳 转 。 打 开 项 目的 字符 串 资源 文件 (strings.xml 文件 ) ， 并 确保 加 
入 了 以 下 资源 : 


<resources> 
«string name="app_name">Messenger</string> 
<string name="username">Username</string> 
<string name="password">Password</string> 
<string name="login">Login</string> 
<string name-"sign up solicitation"> 
Don\'t have an account? Sign up! 
</string> 
<string name="sign up">Sign up</string> 
<string name="phone number">Phone number</string> 
<string name="action settings">settings</string> 
<string name-"hint enter a message">Type a message..</string> 


<!-- Account settings --> 
<string name-"title activity settings">Settings</string> 
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<string name-"pref header account">Rccount</string> 
<string name-"action logout">logout</string> 
</resources> 


下 面 创建 尺寸 维度 资源 文件 Cdimens.xml 文件 ) ， 并 添加 下 列 尺 寸 维度 资源 : 


<?xml version-"1.0" encoding-"utf-8"?» 
«resources» 
<dimen name-"default margin">16dp</dimen> 
<dimen name="default padding">16dp</dimen> 
</resources> 


在 添加 了 所 需 的 项 目 资源 后 ， 返 回 至 activity loginxml 文件 中 ， 并 切换 至 设计 预览 
窗口 ， 以 查看 所 创建 的 布局 效果 ， 如 图 5.1 所 示 。 


PE J - € 


图 5.1 查看 所 创建 的 布局 效果 
该 布局 相对 简单 ， 但 是 却 很 实用 ， 对 于 当前 的 Messenger 应 用 程序 来 说 已 然 足够 。 
1. 创建 登录 视图 
下 面 讨 论 LoginActivity 中 的 工作 流程 。 考 虑 到 采用 MVP 模式 构建 该 应 用 程序 ， 


LoginActivity 此 处 将 视 为 视图 。 显然 ,LoginActivity 与 其 他 通用 视图 有 所 不 同 。 该 视图 更 
多 地 关注 于 逻辑 过 程 。 对 此 ， 应 确定 视图 向 用 户 提供 登录 界面 时 须 具备 的 一 组 必要 行为 ， 
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其 中 包括 : 
Ch ”登录 时 需要 向 用 户 显示 进度 栏 。 
O ”必要 时 应 可 隐藏 进度 栏 。 
OQ ”向 用 户 显示 字段 错误 。 
O “用户 应 可 返回 值 首页 。 
Q ”未 注册 用 户 须 移 至 注册 页 面 。 


在 确认 了 上 述 行为 后 ， 还 应 确保 登录 视图 LoginActivity 具备 此 类 行为 。 对 此 ， 一 种 


较 好 的 方式 是 使 用 接口 。 下 面 在 login 包 中 定义 LoginView 接口 ， 并 包含 下 列 内 容 : 


package com.example.messenger.ui.login 


interface LoginView { 


} 


fun 
fun 
fun 
fun 
fun 
fun 


图 绑 定 至 相应 的 对 象 表达 上 。 除 此 之 外 ， 如 果 出 现 验证 错误 ，LoginView 应 可 向 用 户 提供 


反馈 信息 。 
确 如 此 。 所 有 的 视图 都 可 将 布局 元 素 绑 定 至 程序 对 象 上 。 另 外 ， 如 果 验 证 过 程 中 出 现 问 
题 ， 注 册 视 图 还 应 向 用 户 提供 某 种 反馈 信息 。 

接 下 来 将 构建 两 个 独立 的 接口 , 以 强调 上 述 行为 。 其 中 , 第 一 个 接口 命名 为 BaseView。 
相应 地 ， 在 com.example.messenger.ui 中 构建 base 包 ， 将 BaseView 接口 添加 至 该 包 中 ， 
并 输入 以 下 内 容 : 


package com.example.messenger.ui.base 


ShowProgress () 
hideProgress () 
setUsernameError() 
setPasswordError() 
navigateToSignUp() 
navigateToHome () 


LoginView 工作 良好 ， 但 接口 仍然 存在 些许 问题 。LoginView 需要 将 其 布局 视 


读者 可 能 会 认为 这 两 种 行为 对 于 LoginView 来 说 并 没有 什么 不 同 ， 事 实 也 的 


import android.content.Context 


interface BaseView { 
fun bindViews () 
fun getContext(): Context 


} 


BaseView 接口 要 求 ， 针 对 视图 绑 定 和 上 下 文 检 索 ， 所 实现 的 类 须 声 明 bindViews() 
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和 getContext() EK AL. 
下 面 在 com.example.messenger.ui 中 定义 auth 包 , 并 将 AuthView 接口 添加 至 该 包 中 
如 下 所 示 : 


package com.example.messenger.ui.auth 


interface AuthView { 
fun showAuthError() 
} 


下 面 返回 LoginView 接口 ， 并 确保 扩展 了 BaseView 和 AuthView， 如 下 所 示 : 


package com.example.messenger.ui.login 


import com.example.messenger.ui.auth.AuthView 
import com.example.messenger.ui.base.BaseView 


interface LoginView : BaseView, AuthView { 
fun showProgress() 
fun hideProgress() 
fun setUsernameError () 
fun setPasswordError() 
fun navigateToSignUp () 
fun navigateToHome () 


} 

通过 将 LoginView 接口 声明 为 BaseView 和 AuthView 的 扩展 ， 可 确保 实现 了 
LoginView 的 每 个 类 须 声明 bindViews(). getContext() ll showAuthErrorO 函 数 〈 除 了 声明 
于 LoginView 中 的 函数 之 外 ) 。 需 要 注意 的 是 ， 实 现 了 LoginView 的 任意 类 也 可 视 作 
LoginView、BaseView 和 AuthView 类 型 。 当 某 个 类 涉及 多 种 类 型 时 , 这 一 特性 称 作 多 态 。 

当 LoginView 设置 完毕 后 ， 即 可 与 LoginActivity 协同 工作 。 首 先 ， 可 创建 
LoginActivity， 以 实现 声明 于 BaseView 和 AuthView 中 的 方法 ， 随 后 ， 可 将 此 类 特定 方 
法 添加 至 LoginView 中 。LoginActivity 代码 如 下 所 示 : 


package com.example.messenger.ui.login 


import android.content.Context 

import android.content.Intent 

import android.support.v7.app.AppCompatActivity 
import android.os.Bundle 

import android.view.View 

import android.widget.Button 
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import android.widget.EditText 
import android.widget.ProgressBar 
import android.widget.Toast 
import com.example.messenger.R 


class LoginActivity : AppCompatActivity(), LoginView, View.OnClickListener 
t 


private lateinit var etUsername: EditText 
private lateinit var etPassword: EditText 
private lateinit var btnLogin: Button 

private lateinit var btnSignUp: Button 
private lateinit var progressBar: ProgressBar 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate (savedInstanceState) 
setContentView(R.layout.activity login) 


bindViews() 
) 


当 调 用 时 ， 可 将 布局 视图 对 象 引 用 绑 定 至 视图 元 素 上 ， 如 下 所 示 : 


override fun bindViews() ( 
etUsername = findViewById(R.id.et username) 
etPassword = findViewById(R.id.et password) 
btnLogin - findViewById(R.id.btn login) 
btnSignUp - findViewById(R.id.btn sign up) 
progressBar - findViewById(R.id.progress bar) 
btnLogin.setOnClickListener (this) 
btnSignUp.setOnClickListener (this) 


/ ** 
* Shows an appropriate Authentication error message when invoked. 
E 
override fun showAuthError() { 
Toast.makeText (this, "Invalid username and password combination.", 
Toast.LENGTH LONG).show() 
) 


override fun onClick(view: View) ( 


) 
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override fun getContext(): Context { 
return this 
} 
} 


目前 为 止 ， 一 切 均 较为 顺利 。 我 们 成 功 地 实现 了 LoginActivity 中 的 BaseView 和 


AuthView。 但 仍 需 要 处 理 LoginView 的 特定 方法 ， 包 括 showProgress(). hideProgress(). 
setUsernameError(), setPasswordError(), navigateToSignUpQ LA & navigateToHome( 方 法 。 
下 列 代 码 显 示 了 这 些 方法 的 实现 过 程 ， 随 后 可 将 其 添加 至 LoginActivity 中 。 


LoginView 以 及 View.OnClickListener 接口 。 因 此 ，LoginActivity 提供 了 声明 于 此 类 接 


q 


override fun hideProgress() { 
progressBar.visibility = View.GONE 
} 


override fun showProgress() { 
progressBar.visibility = View.VISIBLE 
} 


override fun setUsernameError() { 
etUsername.error = "Username field cannot be empty" 


} 


override fun setPasswordError() { 
etPassword.error = "Password field cannot be empty" 


} 


override fun navigateToSignUp() { 


} 


override fun navigateToHome() { 


} 
在 添加 了 上 述 所 有 定义 的 方法 后 ， 我 们 即 完成 了 LoginActivity 类 ， 同 时 实现 了 


P 所 声明 的 方法 实现 。 注 意 ， 当 前 LoginActivity 示例 作为 参数 并 通过 this 传递 至 


btnLogin.setOnClickListener0 中 一 一 些 处 声明 了 LoginActivity 并 实现 了 View.OnClickListener。 


因此 ，LoginActivity 表示 为 一 类 有 效 的 View.OnClickListener 实例 (这 也 是 多 态 工 作 方 式 
的 完美 展示 ) 。 


前 述 内 容 讨论 了 登录 视图 的 工作 流程 ， 下 面 将 构建 相应 的 模型 以 处 理 登 录 逻 辑 。 除 
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此 之 外 ， 还 需 创 建 必要 的 服务 以 及 数据 存储 库 ， 以 供 该 模型 通信 使 用 。 针 对 于 此 ， 下 面 
首先 介绍 所 需 的 相关 服务 ， 随 后 将 开发 必要 的 数据 存储 库 。 最 后 ， 还 将 设置 相应 的 截 
取 器 。 

2. 生成 Messenger API 服务 以 及 数据 存储 库 

在 深入 讨论 应 用 程序 开发 之 前 ， 首 先 需要 考察 数据 存储 问题 ， 其 中 涉及 两 个 较为 重 
要 的 话题 ， 即 数据 的 存储 位 置 ， 以 及 存储 数据 的 访问 方式 。 

关于 数据 的 存储 位 置 ， 可 采用 本 地 (在 Android 设备 上 ) 或 远程 (Messenger API) 
方式 实现 。 对 于 后 者 ， 当 访问 数据 时 ， 需 要 创建 合适 的 模型 、 服 务 以 及 存储 库 ， 以 便于 

(1) 通过 SharedPreferences 实现 本 地 数据 存储 

当前 示例 相对 简单 ， 且 无 须 在 本 地 存储 大 量 数 据 。 设 备 上 须 存 储 的 数据 主要 涉及 标 
记 的 访问 以 及 用 户 信 息 。 对 此 ， 可 通过 SharedPreferences 予以 实现 。 

相应 地 ， 可 在 应 用 程序 的 source 包 中 创建 data 包 。 这 里 ， 我 们 计划 与 本 地 存储 和 远 
程 存储 的 数据 协同 工作 ,因此 ,可 在 data 中 分 别 创 建 两 个 额外 的 数据 包 , 即 local Ail remote. 
类 似 于 之 前 讨论 的 俄罗斯 方块 游戏 程序 ， 此 处 将 通过 AppPreferences 类 实现 本 地 持久 化 
存储 。 因 此 ， 可 在 local 包 中 定义 AppPreferences 类 ， 如 下 所 示 : 


package com.example.messenger.data.local 


import android.content.Context 
import android.content.SharedPreferences 
import com.example.messenger.data.vo.UserVO 


class AppPreferences private constructor() ( 
private lateinit var preferences: SharedPreferences 


companion object { 
private val PREFERENCE FILE NAME = "APP PREFERENCES" 


fun create(context: Context): AppPreferences { 
val appPreferences - AppPreferences() 
appPreferences.preferences - context 
.getSharedPreferences (PREFERENCE FILE NAME, 0) 
return appPreferences 
) 
} 
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val accessToken: String? 
get() = preferences.getString("ACCESS TOKEN", null) 


fun storeAccessToken(accessToken: String) { 
preferences.edit().putString("ACCESS TOKEN", accessToken).apply() 
) 


val userDetails: UserVO 
get(): UserVO { 


该 方法 返回 包含 用 户 信息 的 UserVO 实例 ， 如 下 所 示 : 


return UserVO( 
preferences.getLong("ID", 0), 
preferences.getString("USERNAME", null), 
preferences.getString ("PHONE NUMBER", null), 
preferences.getString("STATUS", null), 


} 


相应 地 , 可 将 传递 至 UserVO 的 用 户 信息 存储 至 应 用 程序 的 haredPreferences 文件 中 ， 
如 下 所 示 : 


fun storeUserDetails(user: UserVO) ( 
val editor: SharedPreferences.Editor = preferences.edit() 


editor.putLong("ID", user.id).apply() 
editor.putString("USERNAME", user.username) .apply() 
editor.putString ("PHONE NUMBER", user.phoneNumber).apply() 
editor.putString("STATUS", user.status).apply() 
editor.putString("CREATED AT", user.createdAt) .apply() 


fun clear() { 
val editor: SharedPreferences.Editor = preferences.edit() 
editor.clear() 
editor.apply() 
} 
} 


TE AppPreferences 中 , 分 别 定 义 了 storeAccessToken(String), storeUserDetails(UserVO) 
以 及 clear0 函 数 。 其 中 ，storeAccessToken(String) 用 于 存储 远程 服务 器 和 本 地 预 置 文 件 之 
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间 的 访问 令 牌 。storeUserDetails(UserVO) 接 收 用 户 值 对 象 (包含 用 户 信息 的 数据 对 象 ) 作 
为 其 唯一 参数 ， 并 将 值 对 象 包含 的 信息 存储 于 预 置 文件 中 。 顾 名 思 义 ，clear0 方 法 负责 清 
空 存储 于 预 置 文件 中 的 全 部 数值 。 此 外 ，AppPreferences 还 包含 了 accessToken 和 
userDetails 属性 ， 且 分 别 包含 了 特定 的 getter 函数 ， 以 检索 对 应 值 。 除 了 该 函数 以 及 定义 
于 AppPreferences 中 的 属性 之 外 , 此 处 还 定义 了 伴随 对 象 , 并 设置 了 create(Contexb 函 数 。 
create() 方 法 则 用 于 创建 和 返回 新 的 AppPreferences 实例 。 由 于 使 用 AppPreferences 的 任何 
类 仅 针对 AppPreferences 的 实例 化 方 调用 create0 方 法 ， 因 而 AppPreferences 的 主 构造 函 
数 定义 为 私有 类 型 。 
(2) 生成 值 对 象 

类 似 于 构建 Messenger 后 端 程序 ,此 处 也 需要 创建 值 对 象 并 对 较为 常见 的 数据 类 型 建 
模 。 对 此 ， 可 在 data 包 中 设置 一 个 vo 包 。 实 际 上 ， 读 者 已 对 值 对 象 有 所 了 解 ， 在 前 述 
API 开发 时 已 对 此 有 所 讨论 。 下 面 将 分 别 创建 ConversationListVO 、ConversationVO、 
UserListVO、UserVO 以 及 MessageVO, 生成 Kotlin 文件 并 在 vo 包 中 加 载 这 一 类 值 对 象 。 
在 定义 值 对 象 数据 模型 之 前 ， 首 先 需要 设 定 基本 模型 ， 包 括 UserVO、MessageVO 以 及 
ConversationVO 。 


UserVO 数据 类 的 构建 过 程 如 下 所 示 : 


package com.example.messenger.data.vo 


data class UserVO( 
val id: Long, 
val username: String, 
val phoneNumber: String, 
val status: String, 
val createdAt: String 

) 


考虑 到 之 前 曾 创建 过 值 对 象 ， 因 而 相关 代码 无 须 赣 述 。 下 面 将 MessageVO 加 入 
MessageVO.kt 文件 中 ， 如 下 所 示 : 


package com.example.messenger.data.vo 


data class MessageVO( 
val id: Long, 
val senderId: Long, 
val recipientId: Long, 
val conversationId: Long, 
val body: String, 
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val createdAt: String 
) 


TE ER, fE ConversationVO.kt 文件 中 定义 ConversationVO 数据 类 ， 如 下 所 示 : 


package com.example.messenger.data.vo 


data class ConversationVO( 
val conversationId: Long, 
val secondPartyUsername: String, 
val messages: ArrayList<MessageVO> 
) 
在 定义 了 基本 的 值 对 象 后 ， 即 可 创建 ConversationListVO 和 UserListVO . 


ConversationListVO 定义 如 下 : 


package com.example.messenger.data.vo 


data class ConversationListVO( 
val conversations: List<ConversationVO> 

) 

ConversationListVO 数据 类 定义 了 单一 的 List 类 型 的 conversations 属性 , 其 中 仅 包含 
ConversationVO 类 型 元 素 。UserListVO 类 与 ConversationVO 基本 相同 ， 唯 一 差别 在 于 前 
者 未 包含 用 户 属性 ， 且 仅 涵盖 了 UserVO 属性 元 素 〈 而 非 conversations 属性 ) . UserListVO 
数据 类 如 下 所 示 : 

package com.example.messenger.data.vo 


data class UserListVO( 
val users: List«UserVO» 


) 


3. 检索 远程 数据 

前 述 内 容 讨 论 了 函数 所 需 的 重要 数据 ，Messenger Android App 则 采用 远程 方式 存储 
于 Messenger 后 端 。 对 此 ，Android 应 用 程序 应 可 通过 某 种 方式 访问 后 端 加 载 的 数据 ， 
Messenger 应 用 程序 需要 通过 HTTP 与 API 进行 通信 。 

(OD 与 远程 服务 器 通信 

在 Android 中 ， 存 在 多 种 方式 可 与 远程 服务 器 进行 通信 。Android 社区 中 较为 常用 的 
网 络 库 是 Retrofit, OkHttp 和 Volley。 每 种 库 均 包含 各 自 的 优 缺 点 。 当 前 项 目 将 采用 
Retrofit， 但 出 于 完整 性 考虑 ， 本 章 也 将 介绍 基于 OkHttp 的 远程 服务 器 通信 方式 。 
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(2) 利用 OkHttp 与 服务 器 通信 
OkHttp 是 一 种 高 效 、 便捷 的 HTTP 客户 端 , 支持 同步 和 异步 网 络 调用 。 基 于 Android 
的 OkHttp 应 用 十 分 简单 。 对 此 ， 可 将 其 依赖 关系 添加 至 项 目的 build.gradle 模块 文件 中 ， 
如 下 所 示 : 


implementation 'com.squareup.okhttp3:okhttp:3.9.0' 


G) 利用 OKHttp 向 服务 器 发 送 请 求 
如 前 所 述 ，OkHttp API 的 设计 宗旨 是 易于 使 用 ， 据 此 ， 基 于 OkHttp 的 发 送 请 求 十 分 
快捷 、 可 靠 。 
下 列 post(String,String) 方 法 接收 URL 和 JSON 请 求 体 作为 参数 ， 并 利用 JSON 主体 
向 特定 的 URL 发 送 POST 请 求 。 
fun post(url: String, json: String): String ( 


val mediaType: MediaType - MediaType.parse("application/json; 
charset-utf-8") 


val client:OkHttpClient = OkHttpClient() 
val body: RequestBody = RequestBody.create(mediaType, json) 


val request: Request - Request.Builder() 
-url (url) 
.post (body) 
-build() 


val response: Response = client.newCall (request) .execute() 
return response.body() .string() 
} 
上 述 函数 的 使 用 方式 十 分 简单 ， 读 者 可 通过 适当 值 对 其 进行 调用 ， 就 像 调 用 任何 其 
他 函数 一 样 ， 如 下 所 示 : 
val fullName: String = "John Wayne" 
val response = post("http://example.com", "{ \"full name\": $fullName") 


println (response) 


下 面 尝试 通过 Retrofit 实现 与 远程 服务 器 之 间 的 通信 。 在 讨论 Retrofit 之 前 ， 需 要 对 
HTTP 中 所 发 送 的 数据 建 模 。 
(4) 对 请 求 数据 建 模 
这 里 将 使 用 数据 类 ， 并 对 发 送 至 API 的 HTTP 请 求 数据 建 模 。 下 面 在 remote 包 中 创 
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建 一 个 request 包 ， 其 中 存在 4 种 请 求 且 包含 了 数据 负载 ， 并 被 发 送 至 API 中 ， 即 登录 请 
求 、 消 息 请 求 、 状 态 更 新 请 求 ， 以 及 包含 用 户 数据 的 请 求 。 这 4 种 请 求 分 别 通过 
LoginRequestObject、MessageRequestObject、StatusUpdateRequestObject 以 及 UserRequest 
对 象 进行 建 模 。 

下 列 代码 片段 显示 了 LoginRequestObject 数据 类 ， 可 将 其 添加 至 request 包 中 ， 以 对 
其 他 请 求 执行 相同 的 操作 ， 如 下 所 示 : 


package com.example.messenger.data.remote.request 


data class LoginRequestObject ( 
val username: String, 
val password: String 


) 
LoginRequestObject 数据 类 包含 了 username 和 password 属性 ， 此 类 属性 表示 为 须 提 
供 至 API 登录 端点 的 证 书 。MessageRequestObject 数据 类 定义 如 下 所 示 : 


package com.example.messenger.data.remote.request 


data class MessageRequestObject (val recipientId: Long, val message: String) 
MessageRequestObject 也 包含 了 两 个 属性 , 其 中 , recipientId 表示 接收 消息 的 用 户 ID; 
message 则 表示 被 发 送 的 消息 体 ， 如 下 所 示 : 


package com.example.messenger.data.remote.request 


data class StatusUpdateRequestObject (val status: String) 


StatusUpdateRequestObject 数据 类 包含 了 单一 status 属性 。 顾 名 思 义 ， 该 属性 表示 当 
前 消息 所 更 新 的 状态 ， 如 下 所 示 : 


package com.example.messenger.data.remote.request 


data class UserRequestObject ( 
val username: String, 
val password: String, 
val phoneNumber: String = "" 
) 


UserRequestObject 类 似 于 LoginRequestObject， 但 包含 了 额外 的 phoneNumber 属性 。 
该 请 求 对 象 包含 多 种 用 例 ， 例 如 发 送 至 API 的 用 户 注册 数据 。 
在 生成 了 所 需 的 请 求 对 象 后 ， 下 面 定 义 实际 的 MessengerApiService。 
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(5) 创建 Messenger API 服务 


这 里 将 创建 一 项 服务 , 并 与 第 4 章 构 建 的 Messenger API 进行 通信 , 并 使 用 到 Retrofit 
以 及 Retrofit 的 RxJava 适配器 。 对 于 Android 和 Java 来 说 ，Retrofit 是 Square Inc. 发 布 的 
类 型 安全 的 HTTP 客户 端 ， RxJava 则 是 面向 ReactiveX 的 开源 实现 。 

在 本 章 开始 处 ， 曾 通过 下 列 代码 将 Retrofit 添加 至 Android M H F: 


implementation "com.squareup.retrofit2:retrofit:2.3.0" 


除 此 之 外 ， 还 向 build.gradle 模块 脚本 文件 中 添加 了 Retrofit 的 RxJava 适配器 ， 如 下 


所 示 : 


implementation "com.squareup.retrofit2:adapter-rxjava2:2.3.0" 


当 利 用 Retrofit 构建 服务 时 ， 首 先 需 要 定义 一 个 接口 ， 以 描述 HTTP API。 对 此 ， 可 
在 应 用 程序 source 包 中 设置 一 个 service 包 , 并 添加 MessengerApiService 接口 , 如 下 所 示 : 


package com.example.messenger.service 


import com.example.messenger.data. 
import com.example.messenger.data. 
import com.example.messenger.data. 


StatusUpdateRequestObject 


import com.example.messenger.data. 


import com.example.messenger.data 
import io.reactivex.Observable 
import okhttp3.ResponseBody 
import retrofit2.Retrofit 


remote 
remote 


remote. 


remote. 
EVO 


.request.LoginRequestObject 
.request.MessageRequestObject 


request. 


request.UserRequestObject 


import retrofit2.adapter.rxjava2.RxJava2CallAdapterFactory 
import retrofit2.converter.gson.GsonConverterFactory 


import retrofit2.http.* 
interface MessengerApiService ( 


@POST ("login") 


@Headers ("Content-Type: application/json") 
fun login(@Body user: LoginRequestObject) : 
Observable<retrofit2 .Response<ResponseBody>> 


@POST ("users/registrations") 


fun createUser (@Body user: UserRequestObject): Observable«UserVO» 


QGET ("users") 
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fun listUsers (@Header ("Authorization") authorization: String): 
Observable<UserListVO> 


@PUT ("users") 
fun updateUserStatus ( 
@Body request: StatusUpdateRequestObject, 
@Header ("Authorization") authorization: String): Observable«UserVO» 


@GET ("users/{userId}") 
fun showUser ( 
@Path("userId") userId: Long, 
@Header ("Authorization") authorization: String): Observable<Uservo> 


@GET ("users/details") 
fun echoDetails (@Header ("Authorization") authorization: String): 
Observable«UserVO» 


@POST ("messages") 
fun createMessage( 
(Body messageRequestObject: MessageRequestObject, 
@Header ("Authorization") authorization: String): Observable<MessageVO> 


@GET ("conversations") 
fun listConversations (@Header ("Authorization") authorization: String): 
Observable«ConversationListVO» 


@GET ("conversations/(conversationId)") 
fun showConversation( 
@Path("conversationId") conversationId: Long, 
@Header ("Authorization") authorization: 
String) :Observable<ConversationVo> 


} 
从 上 述 代 码 中 可 以 看 到 , Retrofit 依赖 于 注解 的 使 用 , 进而 描述 被 发 送 的 HTTP 请 求 。 
例如 ， 考 察 下 列 代码 片段 : 


@POST ("login") 

@Headers ("Content-Type: application/json") 
fun login(@Body user: LoginRequestObject) : 
Observable<retrofit2 .Response<ResponseBody>> 


@POST 注解 通知 Retrofit， 对 应 函数 描述 了 映射 至 /login 路 径 的 HTTP POST 请 求 。 
@Headers 注解 用 于 指定 HTTP 请 求 头 。 在 前 述 代 码 片 段 的 HTTP 请 求 中 ，Content-Type 
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头 被 设置 为 application/json。 因 此 ， 该 请 求 发 送 的 内 容 表示 为 JSON。 

@Body 注解 表明 ,传递 至 login0 的 user 包 含 了 JSON 请 求 体 中 的 数据 , 并 发 送 至 API。 
XE, user 定义 为 LoginRequestObject 类 型 (之 前 曾 创建 了 该 请 求 对 象 ) 。 最 后 ， 该 函数 
被 声明 并 返回 Observable 对 象 ， 其 中 包含 了 retrofit2.Response 对 象 。 

除了 @POST、@Headers 和 @Body 注解 之 外 ， 我 们 还 使 用 了 @GET、@PUT、@Path 
和 @Header。 其 中 ，@GET 和 @PUT 分 别 用 于 指定 GET 和 PUT 请求。@Path 注解 则 用 于 
声明 一 个 值 ， 并 作为 所 发 送 的 HTTP 请 求 的 路 径 参数 。 例 如 ， 考 察 下 列 showUserQif Zi: 

GGET ("users/{userId}") 

fun showUser( 

@Path("userId") userId: Long, 
@Header ("Authorization") authorization: String): Observable«UserVO» 

函数 showUserO 描 述 了 包含 users/{userld} HEH GET 请 求 。 这 里 ，{fuserId} 并 非 是 
HTTP 请 求 路 径 中 的 实际 内 容 。Retrofit 将 利用 传递 至 showUser0 中 的 userId 值 。 此 处 应 
注意 userId 如 何 采 用 @Path("userId") 进 行 注 解 , 这 将 通知 Retrofit, userld 加 载 了 一 个 数值 ， 
且 应 置 于 HTTP 请 求 URL 路 径 中 {fuserId} 所 处 位 置 处 。 

@Header 与 @Headers 类 似 ， 唯 一 差别 在 于 ， 前 者 用 于 指定 所 发 送 的 HTTP 请 求 中 的 
键 - 值 对 。 基 于 @Header("Authorization") 的 注解 验证 将 设置 HTTP 请 求 的 Authorization 头 

(发 送 至 验证 中 的 数值 〉。 

前 述 内 容 创 建 了 MessengerApiService 接口 ， 并 对 应 用 程序 通信 的 HTTP API 建 模 。 
接 下 来 ， 我们 需要 检索 对 应 服务 的 实例 。 对 此 ， 可 定义 伴生 对 象 ， 负 责 创建 
MessengerApiService 实例 ， 如 下 所 示 : 


package com.example.messenger.service 


import com.example.messenger.data.remote.request.LoginRequestObject 
import com.example.messenger.data.remote.request.MessageRequestObject 
import com.example.messenger.data.remote.request. 
StatusUpdateRequestObject 

import com.example.messenger.data.remote.request.UserRequestObject 
import com.example.messenger.data.vo.* 

import io.reactivex.Observable 

import okhttp3.ResponseBody 

import retrofit2.Retrofit 

import retrofit2.adapter.rxjava2.RxJava2CallAdapterFactory 

import retrofit2.converter.gson.GsonConverterFactory 

import retrofit2.http.* 
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interface MessengerApiService ( 


companion object Factory { 
private var service: MessengerApiService? - null 


当 调 用 时 ， 该 对 象 返回 MessengerApiService 实例 。 若 之 前 未 曾 创建 ， 此 时 将 生成 一 
个 新 的 MessengerApiService 实例 ， 如 下 所 示 : 


fun getInstance(): MessengerApiService ( 
if (service -- null) ( 


val retrofit = Retrofit.Builder() 
-addCallAdapterFactory (RxJava2CallAdapterFactory.create|()) 
-addConverterFactory (GsonConverterFactory.create()) 
-baseUrl("(AWS URL]") 
// replace AWS URL with URL of AWS EC2 
// instance deployed in the previous chapter 
-build() 


service = retrofit.create(MessengerApiService::class.java) 


} 


return service as MessengerApiService 
} 
} 
} 


Factory 定义 了 单一 的 getInstanceQ ER Be, 并 在 调用 时 构建 和 返回 MessengerApiService 
实例 。RetrofitBuilder 实例 用 于 创建 该 接口 。 其 中 ， 可 将 CallAdapterFactory 设置 为 
RxJava2CallAdapterFactory， 将 ConverterFactory 设置 为 GSonConverterFactory (这 将 处 理 
JSON 序列 化 和 反 序 列 化 操作 〉。 注 意 ， 期 间 不 要 忘记 将 "{AWS_URL}" 蔡 换 为 Messenger 
API AWS EC2 实例 的 URL (参见 第 4 章 ) 。 

在 成 功 地 构建 了 Retrofit.Builder0 实 例 后 ， 即 可 以 此 生成 MessengerApiService 实例 ， 
如 下 所 示 : 
service = retrofit.create (MessengerApiService::class.java) 
尽管 已 经 创建 了 一 个 相关 服务 与 Messenger API 通信 ， 但 如 果 未 在 AndroidManifest 
中 指定 必要 的 权限 ， 仍 无 法 使 用 该 服务 与 网 络 通信 。 打 开 项 目的 AndroidManifest 文件 ， 
在 <manifest></manifest> 标 签 之 间 添 加 下 列 代码 : 
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<uses-permission android:name="android.permission. INTERNET" /> 
«uses-permission android:name-"android.permission.ACCESS NETWORK STATE" /> 


Tfj, Messenger 服务 已 可 使 用 ， 下 面 将 创建 相应 的 存储 库 并 使 用 该 服务 。 

(6) 实现 数据 存储 库 

相信 读者 已 对 存储 库 有 所 了 解 ， 此 处 不 再 袭 述 。 此 处 将 要 生成 的 存储 库 与 第 4 章 类 
似 ， 唯 一 的 差别 在 于 ， 这 里 所 实现 的 存储 库 数 据 源 为 原创 服务 器 ， 而 非 驻 留 于 主机 上 的 
数据 库 。 

下 面 在 remote 包 中 创建 repository 包 , 并 实现 用 户 存 储 库 , 以 检索 与 应 用 程序 用 户 相 
关 的 数据 。 下 列 代码 将 UserRepository 接口 添加 至 当前 存储 库 中 。 


package com.example.messenger.data.remote.repository 


import com.example.messenger.data.vo.UserListVO 
import com.example.messenger.data.vo.UserVO 
import io.reactivex.Observable 


interface UserRepository { 


fun findById(id: Long): Observable«UserVO» 
fun all(): Observable«UserListVO» 
fun echoDetails(): Observable«UserVO» 

) 


考虑 到 接口 的 特性 , 我 们 需要 定义 一 个 UserRepositoryImpl 25, 并 实现 UserRepository 
中 函数 。 下 面 在 repository 包 中 定义 UserRepositoryImpl 类 ， 如 下 所 示 : 


package com.example.messenger.data.remote.repository 


import android.content.Context 

import com.example.messenger.service.MessengerApiService 
import com.example.messenger.data.local.AppPreferences 
import com.example.messenger.data.vo.UserListVO 

import com.example.messenger.data.vo.UserVO 

import io.reactivex.Observable 


class UserRepositoryImpl(ctx: Context) : UserRepository { 
private val preferences: AppPreferences = AppPreferences.create (ctx) 


private val service: MessengerApiService = 
MessengerApiService.getInstance() 
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override fun findById(id: Long): Observable<UserVO> { 
return service.showUser(id, preferences.accessToken as String) 


} 


override fun all(): Observable«UserListVO» { 
return service.listUsers (preferences.accessToken as String) 


) 


override fun echoDetails(): Observable«UserVO» { 
return service.echoDetails (preferences.accessToken as String) 


} 

} 

UserRepositoryImpl 类 定义 了 两 个 实例 变量 , 即 preferences 和 service。 其 中 , preferences 
变量 表示 为 之 前 生成 的 AppPreferences 类 实例 ; service 则 表示 为 MessengerApiService 实 
例 ， 该 实例 通过 定义 于 MessengerApiService 接口 的 、Factory 伴随 对 象 中 的 getInstance() 
函数 得 到 。 

UserRepositoryImpl 类 提供 了 定义 于 UserRepository 中 的 findById() . all() 和 
echoDetails() 函 数 实现 。 这 3 个 函数 使 用 了 service 并 通过 HTTP 请 求 检索 服务 器 上 的 所 需 
数据 。findByIdO 调 用 了 服务 中 的 showUser0 函 数 ， 向 Messenger API 发 送 请 求 ， 并 利用 
特定 的 用 户 ID 检索 用 户 的 详细 信息 。showUser0 函 数 需要 使 用 到 当前 登录 用 户 的 授权 令 
牌 作 为 第 二 个 参数 。 该 令 牌 可 通过 AppPreferences 实例 获得 ， 即 作为 第 二 个 参数 向 函数 
传递 preferences.accessToken. 

all0 函 数 利 用 MessengerApiServiceflistUsers0 检 索 消 息 服务 器 上 的 所 有 用 户 。 
echoDetails() 则 通过 MessengerApiService#techoDetailsO 获 取 当 前 登录 用 户 的 详细 信息 。 

下 面 创 建 会 话 存储 库 ， 以 简化 与 会 话 相 关 的 数据 访问 操作 。 下 列 代码 将 
ConversationRepository 接口 添加 至 com.example.messenger.data.remote.repository 中 。 


package com.example.messenger.data.remote.repository 


import com.example.messenger.data.vo.ConversationListVO 
import com.example.messenger.data.vo.ConversationVO 
import io.reactivex.Observable 


interface ConversationRepository { 
fun findConversationById(id: Long): Observable«ConversationVO» 


fun all(): Observable«ConversationListVO»^ 


) 
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接 下 来 在 当前 包 中 构建 对 应 的 ConversationRepositoryImpl. W Fr: 


package com.example.messenger.data.remote.repository 


import android.content.Context 

import com.example.messenger.service.MessengerApiService 
import com.example.messenger.data.local.AppPreferences 
import com.example.messenger.data.vo.ConversationListVO 
import com.example.messenger.data.vo.ConversationVO 
import io.reactivex.Observable 


class ConversationRepositoryImpl(ctx: Context) : ConversationRepository { 


private val preferences: AppPreferences = AppPreferences.create (ctx) 
private val service: MessengerApiService - MessengerApiService 
-getInstance() 


这 将 利用 Messenger API 中 的 请 求 会 话 ID 检索 与 会 话 相 关 的 信息 ， 如 下 所 示 : 


override fun findConversationById(id: Long): Observable<ConversationVO> { 
return service.showConversation(id, preferences.accessToken as String) 


} 
当 被 调用 时 ， 该 函数 将 从 API 中 检索 当前 用 户 的 所 有 活动 会 话 ， 如 下 所 示 : 


override fun all(): Observable<ConversationListVO> { 
return service.listConversations (preferences.accessToken as String) 


) 
} 


findConversationById(Long) 函 数 利 用 传递 至 该 函数 中 的 对 应 ID 检索 会 话 线程 。all0 
函数 简单 地 检索 当前 用 户 的 全 部 活动 会 话 。 
4. 构建 登录 交互 器 


下 面 创建 登录 交互 器 , 即 与 登录 显示 相交 互 的 模型 。 在 login 包 中 定义 LoginInteractor 
接口 ， 如 下 所 示 : 


package com.example.messenger.ui.login 


import com.example.messenger.data.local.AppPreferences 
import com.example.messenger.ui.auth.AuthInteractor 


interface LoginInteractor : AuthInteractor { 
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interface OnDetailsRetrievalFinishedListener ( 
fun onDetailsRetrievalSuccess() 
fun onDetailsRetrievalError() 


fun login(username: String, password: String, 
listener: AuthInteractor.onAuthFinishedListener) 


fun retrieveDetails (preferences: AppPreferences, 
listener: OnDetailsRetrievalFinishedListener) 


) 

相信 读者 已 经 注意 到 ，LoginInteractor 扩展 了 AuthInteractor, XX- LoginView 和 
AuthView 之 间 的 扩展 方式 类 似 。AuthInteractor 中 声明 的 行为 和 特性 需要 通过 处 理 验 证 逻 
辑 的 交互 器 予以 实现 ， 下 面 对 此 予以 实现 。 

相应 地 ， 将 AuthInteractor 接口 添加 至 com.exampla.messenger.auth 包 中 ， 如 下 所 示 : 


package com.example.messenger.ui.auth 


import com.example.messenger.data.local.AppPreferences 
import com.example.messenger.data.remote.vo.UserVO 


interface AuthInteractor { 


var userDetails: UserVO 
var accessToken: String 
var submittedUsername: String 
var submittedPassword: String 


interface onAuthFinishedListener { 
fun onAuthSuccess() 
fun onAuthError() 
fun onUsernameError() 
fun onPasswordError() 


fun persistAccessToken (preferences: AppPreferences) 


fun persistUserDetails (preferences: AppPreferences) 


} 
其 中 ， 表 示 为 AuthInteractor 的 某 一 个 交互 器 须 包 含 下 列 字段 : userDetails 、 
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accessToken, submittedUsername 以 及 submittedPassword. 除 此 之 外 , 实现 了 AuthInteractor 
的 交互 器 还 需 定 义 persistAccessToken(AppPreferences) 和 persistUserDetails(AppPreferences) 
方法 ， 这 些 方法 负责 访问 令 牌 和 用 户 信息 与 应 用 程序 SharedPreferences 文件 之 间 的 持久 
化 操作 。 可 能 读者 已 经 猜测 到 ， 这 里 需要 针对 LoginInteractor 定义 一 个 实现 类 ， 即 
LoginInteractorImpl 类 。 

在 下 列 代 码 中 ，LoginInteractorImpl 类 定义 了 实现 后 的 login0 方 法 ， 并 将 该 类 添加 至 
ui £18 login 包 中 。 


package com.example.messenger.ui.login 


import com.example.messenger.data.local.AppPreferences 

import com.example.messenger.data.remote.request.LoginRequestObject 
import com.example.messenger.data.vo.UserVO 

import com.example.messenger.service.MessengerApiService 

import com.example.messenger.ui.auth.AuthInteractor 

import io.reactivex.android.schedulers.AndroidSchedulers 

import io.reactivex.schedulers.Schedulers 


class LoginInteractorImpl : LoginInteractor { 


override lateinit var userDetails: UserVO 
override lateinit var accessToken: String 
override lateinit var submittedUsername: String 
override lateinit var submittedPassword: String 


private val service: MessengerApiService = MessengerApiService 
-getInstance() 


override fun login(username: String, password: String, 
listener: AuthInteractor.onAuthFinishedListener) ( 
when { 


如 果 登 录 框 输入 了 空 username, WIZ username 视 为 无 效 。 当 出 现 这 一 情况 时 ， 将 调 
用 监听 器 的 onUsernameError0 函 数 ， 如 下 所 示 : 


username.isBlank() -> listener.onUsernameError () 


同样 ， 若 输入 空 password， 则 调用 监听 器 的 onPasswordError0 函 数 ， 如 下 所 示 : 


password.isBlank() -> listener.onPasswordError () 
else -> ( 
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下 列 代码 初始 化 模型 的 submittedUsername 和 submittedPassword 字段 , 并 生成 相应 的 
LoginRequestObject 


submittedUsername - username 
submittedPassword = password 
val requestObject - LoginRequestObject (username, password) 


通过 MessengerApiService， 可 向 Messenger API 发 送 登录 请 求 ， 如 下 所 示 : 


service.login(requestObject) 
-subscribeOn (Schedulers.io()) 
// subscribing Observable to Scheduler thread 
-observeOn (AndroidSchedulers.mainThread()) 
// setting observation to be done on the main thread 
.subscribe(( res -> 


if (res.code() != 403) { 
accessToken - res.headers()["Authorization"] as String 
listener.onAuthSuccess() 

) else ( 


当 服 务 器 返回 一 个 HTTP 403 CLERO 状态 码 时 ， 则 表明 登录 无 效 ， 且 用 户 未 被 授权 
访问 服务 器 ， 如 下 所 示 : 
listener.onAuthError () 
} 
}, { error -> 


listener.onAuthError() 
error.printStackTrace() 


login0 首 先 检测 username 和 password 参数 是 否 为 空 。 当 出 现 空 用户 名 时 ， 将 调用 
onAuthFinishedListener 的 onUsernameError() 函数 ; 若 出 现 空 密码 ， 则 调用 
onPasswordError0。 和 否则， 将 利用 MessengerApiService 向 Messenger API 发 送 登 录 请 求 。 
若 成 功 ， 则 将 ccessToken 属性 设置 为 API Authorization 响应 头 中 的 访问 令 牌 ， 并 于 随后 
调用 监听 器 的 onAuthSuccess0 函 数 。 当 登录 无 效 时 ， 将 调用 onAuthError0 监 听 器 函数 。 

在 理解 了 登录 流程 后 , 即 可 将 retrieveDetails(). persistAccessToken() 和 persistUserDetails() 
方法 添加 至 LoginInteractorImpl 中 ， 如 下 所 示 : 
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override fun retrieveDetails (preferences: AppPreferences, 
listener: LoginInteractor.OnDetailsRetrievalFinishedListener) 


( 
这 将 在 首次 登录 时 检索 用 户 信息 ， 如 下 所 示 : 


service.echoDetails (preferences.accessToken as String) 
-subscribeOn (Schedulers.io()) 
-observeOn (AndroidSchedulers.mainThread()) 
.subscribe(( res -> 
userDetails = res 
listener.onDetailsRetrievalSuccess()], 
{ error -> 
listener.onDetailsRetrievalError () 
error.printStackTrace()]) 


} 


override fun persistAccessToken(preferences: AppPreferences) { 
preferences. storeAccessToken (accessToken) 


} 


override fun persistUserDetails (preferences: AppPreferences) { 
preferences.storeUserDetails (userDetails) 


) 

读者 应 理解 上 述 代 码 片段 中 的 注释 内 容 , 其 中 解释 了 LoginInteractor 的 工作 机 制 。 下 
面 处 理 LoginPresenter 的 实现 过 程 。 
5. 构建 登录 presenter 
presente 表示 为 视图 和 模型 之 间 的 中 间 人 ， 且 有 必要 针对 视图 构建 相应 的 presenter; 
以 实现 更 为 清晰 的 视图 -模型 交互 。 该 过 程 较为 简单 ， 首 先 需要 定义 一 个 接口 ， 声 明 
presenter 所 展示 的 各 种 行为 。 对 此 ， 可 在 login 包 中 定义 一 个 LoginPresenter 接口 ， 如 下 
所 示 : 


package com.example.messenger.ui.login 


interface LoginPresenter { 
fun executeLogin(username: String, password: String) 


} 


不 难 发 现 ， 在 上 述 代码 片段 中 ， 需 要 定义 一 个 类 ， 该 类 针对 LoginView WE 
LoginPresenter， 并 传递 一 个 executeLogin(String，String) 函 数 。 该 函数 被 视图 所 调用 ， 并 
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于 随后 与 处 理应 用 程序 登录 逻辑 的 模型 交互 。 此 处 ， 需 要 定义 一 个 实现 了 LoginPresenter 
的 LoginPresenterImpl 类 ， 如 下 所 示 : 


package com.example.messenger.ui.login 


import com.example.messenger.data.local.AppPreferences 
import com.example.messenger.ui.auth.AuthInteractor 


class LoginPresenterImpl(private val view: LoginView) : 
LoginPresenter, AuthInteractor.onAuthFinishedListener, 
LoginInteractor.OnDetailsRetrievalFinishedListener { 


private val interactor: LoginInteractor = LoginInteractorImpl() 
private val preferences: AppPreferences - 
AppPreferences.create (view.getContext ()) 


override fun onPasswordError() { 
view.hideProgress() 
view.setPasswordError () 


override fun onUsernameError() { 
view. hideProgress () 
view. setUsernameError () 


override fun onAuthSuccess() { 
interactor.persistAccessToken (preferences) 
interactor.retrieveDetails(preferences, this) 


} 


override fun onAuthError() { 
view. showAuthError () 
view.hideProgress () 


} 


override fun onDetailsRetrievalSuccess() { 
interactor.persistUserDetails (preferences) 
view.hideProgress () 
view.navigateToHome () 
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override fun onDetailsRetrievalError() { 
interactor.retrieveDetails (preferences, this) 


} 


override fun executeLogin(username: String, password: String) { 
view. showProgress () 
interactor.login(username, password, this) 

} 

} 

LoginPresenterlmpl 类 实现 了 LoginPresenter. AuthInteractor.onAuthFinishedListener 
以 及 LoginInteractor.OnDetailsRetrievalFinishedListener， 因 而 也 实现 了 接口 所 需 的 全 部 行 
为 ,LoginPresenterImpl $i} 98 Y 7 个 函数 , 分 别 是 onPasswordError() , onUsernameError() . 
onAuthSuccess(). onAuthError(). onDetailsRetrievalSuccess(). onDetailsRetrievalError() il 
executeLogin(String, String). LoginPresenter 和 LoginInteractor 之 间 的 交互 行为 可 视 为 位 于 
onAuthSuccess() 和 executeLogin(String, String) 函数 中 。 当 用 户 提交 其 登录 信息 时 ， 
LoginView 将 调用 LoginPresenter 中 的 executeLogin(String，String) 函 数 。 相 应 地 ， 
LoginPresenter 利用 LoginInteractor 处 理 处 理 实际 的 登录 过 程 ， 即 调用 LoginInteractor 中 
的 login(String, String) Fi Zt 

如 果 用 户 登 录 成 功 ，LoginPresenter 的 onAuthSuccess0 回 调 函 数 将 被 LoginInteractor 
所 调用 。 随 后 ， 将 存储 服务 器 返回 的 访问 令 牌 ， 以 及 登录 用 户 的 信息 检索 。 若 登录 请 求 
被 服务 器 所 拒绝 ，onAuthError0 将 被 调用 ， 并 向 用 户 显示 错误 消息 。 

当 用 户 账 户 信 息 成 功 地 被 交互 器 所 检索 ， 将 调用 LoginPresenter 的 
onDetailsRetrievalSuccessO 〇 回调 函数 ， 从 而 引发 账户 信息 的 存储 操作 。 随 后 ， 登 录 过 程 中 
向 用 户 显示 的 进程 栏 将 通过 view.hideProgress0 被 隐藏 ， 接 下 来 ， 用 户 将 通过 
view.navigateToHome() 导 航 至 主屏 幕 中 。 如 果 用 户 信息 检索 失败 , onDetailsRetrievalError() 
将 被 LoginInteractor 调用 。presenter 将 再 次 请 求 并 检索 用 户 账户 信息 ， 即 再 次 调用 
interactor.retrieveDetails(preferences, this). 

6. 完成 LoginView 


回忆 一 下 ， 前 述 内 容 尚未 完成 LoginView; navigateToSignUp(). navigateToHome() 
和 onClick(view: View) 函 数 中 的 相关 内 容 也 未 予定 义 。 除 此 之 外 ，LoginView 也 未 采用 任 
何方 式 与 LoginPresenter 进行 交互 ， 下 面 对 此 加 以 讨论 。 

首先 ， 当 用 户 进入 注册 页 面 或 主屏 幕 时 ， 需 要 针对 此 类 画面 提供 相应 的 视图 。 当 前 ， 
我 们 暂 不 需要 考虑 此 类 视图 的 实现 过 程 〈 后 续 内 容 将 对 此 加 以 分 析 ) 。 对 此 ， 可 在 
com.example.messenger.ui 下 设置 signup fll main 包 , 并 在 signup 包 中 生成 名 为 SignUpActivity 
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的 空 活动 ， 以 及 在 main 包 中 生成 名 为 MainActivity 的 空 活动 。 
下 面 打开 LoginActivity.kt 文件 ， 调 整 之 前 所 定义 的 函数 以 执行 相应 的 任务 。 另 外 ， 
还 需 针 对 LoginPresenter 实例 和 AppPreferences 实例 添加 私有 属性 ， 相 关 变 化 内 容 将 在 后 
续 代码 中 体现 。 

首先 ， 在 LoginActivity 类 开始 处 添加 下 列 属性 : 

private lateinit var progressBar: ProgressBar 


private lateinit var presenter: LoginPresenter 
private lateinit var preferences: AppPreferences 


随后 ,调整 navigateToSignUp(). navigateToHome()fil onClick(view: View) 方 法 ， 如 下 
所 示 : 
override fun navigateToSignUp() { 


startActivity(Intent(this, SignUpActivity::class.java)) 
) 


override fun navigateToHome() ( 

finish() 

startActivity (Intent (this, MainActivity::class.java)) 
} 


override fun onClick(view: View) { 
if (view.id == R.id.btn_login) { 
presenter.executeLogin(etUsername.text.toString(), 
etPassword.text.toString()) 
) else if (view.id == R.id.btn sign up) { 
navigateToSignUp() 
} 
} 


当 调 用 navigateToSignUp() 方 法 时 , 该 方法 使 用 一 个 显 式 意 图 , 并 启动 SignUpActivity。 
navigateToHome() 的 操作 方式 类 似 于 navigateToSignUpO ， 即 启动 MainActivity 。 
navigateToHome() 和 navigateToSignUpO 之 间 的 主要 差别 在 于 ，navigateToHomeO 在 启用 
MainActivity 之 前 通过 调用 finishO 销 毁 当 前 LoginActivity 实例 。 

单 击 登录 按钮 后 ，onClick0 方 法 使 用 LoginPresenter 开始 执行 登录 处 理 操 作 。 和 否则 ， 
当 单 击 注册 按钮 时 ，SignUpActivity 则 通过 navigateToSignUpO 启 动 。 

至 此 ， 与 登录 应 用 程序 相关 的 视图 、presenter 已 经 构建 完毕 。 需 要 注意 的 是 ， 在 用 

户 登 录 前 ， 需 要 注册 为 该 平台 的 用 户 。 因 此 ， 还 需 实现 注册 逻辑 ， 下 面 将 对 此 加 以 讨论 。 
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5.1.3. 设计 注册 UI 


本 节 讨 论 用 户 注册 界面 。 首 先 ， 应 在 SignUpActivity 布局 基础 上 实现 相关 的 视图 。 
SignUpActivity 布局 并 未 涉及 太 多 内 容 ， 其 中 包括 3 个 输入 框 ， 用 以 输入 用 户 名 、 密 码 以 
及 注册 用 户 的 电话 号 码 。 除 此 之 外 ， 还 包含 了 一 个 按钮 ， 以 提交 注册 表单 ， 以 及 注册 处 
理 过 程 中 的 进度 栏 。 

activity sign up.xml 布局 文件 如 下 所 示 : 


<?xml version-"1.0" encoding-"utf-8"?» 
Xandroid.support.constraint.ConstraintLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
xmlns:tools-"http://schemas.android.com/tools" 
android:layout width-"match parent" 
android:layout height-"match parent" 
tools:context-".ui.signup.SignUpActivity" 
android:paddingTop-"Gdimen/default padding" 
android:paddingBottom="@dimen/default padding" 
android:paddingStart="@dimen/default padding" 
android:paddingEnd="@dimen/default padding" 
android:orientation="vertical" 
android:gravity-"center horizontal"> 
<EditText 
android: id="@+id/et username" 
android:layout width="match parent" 
android: layout height-"wrap content" 
android:hint="@string/username" 
android: inputType="text"/> 
<EditText 
android: id="@+id/et phone" 
android: layout width="match parent" 
android: layout height="wrap content" 
android: layout marginTop="@dimen/default margin" 
android:hint="@string/phone number" 
android: inputType="phone"/> 
<EditText 
android: id="@+tid/et password" 
android:layout width="match parent" 
android: layout height="wrap content" 
android: layout_marginTop="@dimen/default_margin" 


android:hint="@string/password" 
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android:inputType-"textPassword"/» 

«Button 
android:id-"Q(*id/btn sign up" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout marginTop="@dimen/default margin" 
android:text="@string/sign up"/> 

<ProgressBar 
android:id="@+id/progress bar" 
android: layout width-"wrap content" 
android: layout_height="wrap content" 
android: layout_marginTop="@dimen/default_margin" 
android: visibility="gone"/> 

</android.support.constraint.ConstraintLayout> 


对 应 的 XML 布局 效果 如 图 5.2 所 示 。 


Messenger 


Username 


Phone number 


Password 


图 5.2 XML 布局 效果 
不 难 发 现 ， 当 前 所 设计 的 布局 包含 了 之 前 所 提 到 的 全 部 元 素 。 
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1. 构建 注册 交互 器 


下 面 实现 注册 交互 器 ， 并 继续 讨论 之 前 未 完成 的 模型 。 对 此 ， 在 signup 包 中 定义 
SignUpInteractor 接口 ， 如 下 所 示 : 


package com.example.messenger.ui.signup 
import com.example.messenger.ui.auth.AuthInteractor 
interface SignUpInteractor : AuthInteractor { 


interface OnSignUpFinishedListener { 
fun onSuccess() 
fun onUsernameError() 
fun onPasswordError() 
fun onPhoneNumberError () 
fun onError() 


} 


fun signUp(username: String, phoneNumber: String, password: String, 
listener: OnSignUpFinishedListener) 


fun getAuthorization(listener: AuthInteractor.onAuthFinishedListener) 

} 

读者 可 能 已 经 注意 到 , SignUpInteractor 扩展 了 AuthInteractor。 类 似 于 LoginInteractor, 
SignUpInteractor 需要 使 用 到 userDetails、\accessToken submittedUsername 和 submittedPassword 
属性 。 除 此 之 外 , 通过 persistAccessToken(AppPreferences) 和 persistUserDetails(AppPreferences) 
函数 ，SignUpInteractor 应 可 实现 用 户 访问 令 牌 和 信息 的 持久 化 存储 ， 这 两 个 函数 声明 于 
AuthInteractor 接口 中 。 

SignUpInteractor 中 定义 了 接口 OnSignUpFinishedListener， 并 声明 了 回调 函数 ， 并 通 
过 OnSignUpFinishedListener 予以 实现 。 当 对 此 加 以 实现 时 ， 该 监听 器 记 为 SignUpPresenter。 

在 构建 SignUpInteractorImpl 时 ， 首 先 应 考察 其 属性 声明 以 及 login0 方 法 实现 ， 并 确 
保 将 SignUpInteractorImpl 添加 至 与 SignUpInteractor 相同 的 包 中 ， 如 下 所 示 : 


package com.example.messenger.ui.signup 


import android.text.TextUtils 

import android.util.Log 

import com.example.messenger.data.local.AppPreferences 

import com.example.messenger.data.remote.request.LoginRequestObject 
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import 
import 
import 
import 
import 
import 


com.example.messenger.data.remote.request.UserRequestObject 
com.example.messenger.data.vo.UserVO 
com.example.messenger.service.MessengerApiService 
com.example.messenger.ui.auth.AuthInteractor 
io.reactivex.android.schedulers.AndroidSchedulers 
io.reactivex.schedulers.Schedulers 


class SignUpInteractorImpl : SignUpInteractor { 


override lateinit var userDetails: UserVO 
override lateinit var accessToken: String 


override lateinit var submittedUsername: String 
override lateinit var submittedPassword: String 


private val service: MessengerApiService - MessengerApiService 


-getInstance() 


override fun signUp(username: String, 


phoneNumber: String, password: String, 
listener: SignUpInteractor.OnSignUpFinishedListener) { 


submittedUsername = username 
submittedPassword = password 
val userRequestObject = UserRequestObject (username, password, 


phoneNumber) 


when { 
TextUtils.isEmpty(username) -> listener.onUsernameError () 
TextUtils.isEmpty(phoneNumber) -> listener.onPhoneNumberError () 
TextUtils.isEmpty (password) -> listener.onPasswordError () 
else -> { 


接 下 来 利用 MessengerApiService 7E Messenger 平台 中 注册 新 用 户 ， 如 下 所 示 : 


service.createUser (userRequestObject) 
-subscribeOn(Schedulers.io()) 
-observeOn (AndroidSchedulers.mainThread()) 
.subscribe(( res -> 
userDetails - res 
listener.onSuccess() 
), ( error -> 
listener.onError() 
error.printStackTrace() 
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下 面 将 getAuthorization() 、 persistAccessToken() 和 persistUserDetails() 添 加 至 
SignUpInteractorImpl 中 ， 如 下 所 示 : 


override fun getAuthorization (listener: 
AuthInteractor.onAuthFinishedListener) ( 


val userRequestObject - LoginRequestObject (submittedUsername, 
submittedPassword) 


下 面 利 用 MessengerApiService 将 注册 用 户 登 录 至 当前 平台 中 ， 如 下 所 示 : 


service.login (userRequestObject) 
. subscribeOn (Schedulers.io()) 
-observeOn (AndroidSchedulers.mainThread()) 


.subscribe( { res -> 


accessToken - res.headers()["Authorization"] as String 


在 用 户 成 功 登 录 后 ， 可 调用 监听 器 的 onAuthSuccessO0 回 调 函数 ， 如 下 所 示 : 


listener.onAuthSuccess() 


}, { error -> 
listener.onAuthError () 
error.printStackTrace() 


}) 


override fun persistAccessToken (preferences: AppPreferences) { 
preferences. storeAccessToken (accessToken) 


} 


override fun persistUserDetails (preferences: AppPreferences) { 
preferences.storeUserDetails (userDetails) 
) 
SignUpInteractorImpl 类 则 是 SignUpInteractor 的 直接 实现 。 对 于 AuthInteractor 中 包 
ffi] userDetails, accessToken, submittedUsemame 以 及 submittedPassword， 第 19-22 行 代 
人 码 包 含 了 属性 声明 。signUp(String, String, String,SignUpInteractor.OnSignUpFinishedListener) 
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包含 了 当前 应 用 程序 的 注册 逻辑 。 如 果 用 户 提交 的 全 部 数值 均 为 有 效 ， 那 么 ， 用 户 利用 
MessengerApiService 〈 通 过 Retrofit 创建 ) 的 createUser(UserRequestObjecb 函 数 在 当前 平 
台 上 完成 注册 。 
调用 getAuthorization(AuthInteractor.onAuthFinishedListener) 函 数 将 对 Messenger 平台 
上 的 新 用 户 注册 用 户 授 权 。 此 处 ， 读 者 应 留意 SignUpInteractorImpl 中 的 注释 ， 以 了 解 更 
多 内 容 。 
下 面 将 创建 SignUpPresenter。 
2. 创建 注册 presenter 


正如 构建 LoginPresenter 所 做 的 那样 ， 当 前 也 需要 定义 SignUpPresenter 接口 以 及 
SignUpPresenterImpl 类 。 这 里 ，SignUpPresenterImpl 的 构建 过 程 并 不 复杂 。 对 于 当前 应 用 
程序 ， 注册 presenter 应 包含 AppPreferences 类 型 的 属性 ， 以 及 执行 注册 处 理 的 相关 函数 。 
SignUpPresenter 接口 定义 如 下 : 


package com.example.messenger.ui.signup 


import com.example.messenger.data.local.AppPreferences 


interface SignUpPresenter ( 
var preferences: AppPreferences 


fun executeSignUp(username: String, phoneNumber: String, password: 
String) 
} 


SignUpPresenter 的 实现 代码 如 下 所 示 : 


package com.example.messenger.ui.signup 


import com.example.messenger.data.local.AppPreferences 
import com.example.messenger.ui.auth.AuthInteractor 


class SignUpPresenterImpl (private val view: SignUpView): SignUpPresenter, 
SignUpInteractor.OnSignUpFinishedListener, 
AuthInteractor.onAuthFinishedListener ( 


private val interactor: SignUpInteractor = SignUpInteractorImpl() 
override var preferences: AppPreferences - AppPreferences 


-create (view.getContext ()) 
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当 用 户 成 功 注 册 后 ，onSuccess0 〇 函数 将 被 调用 ， 如 下 所 示 : 


override fun onSuccess() ( 
interactor.getAuthorization (this) 


} 
若 用 户 在 注册 过 程 中 出 现 错误 ， 则 调用 下 列 回调 函数 : 


override fun onError() ( 
view.hideProgress() 
view. showSignUpError () 


} 


override fun onUsernameError() { 
view. hideProgress () 
view. setUsernameError () 


override fun onPasswordError() { 
view. hideProgress () 
view.setPasswordError () 


override fun onPhoneNumberError() { 
view. hideProgress () 
view. setPhoneNumberError () 


override fun executeSignUp(username: String, phoneNumber: String, 


password: String) { 
view. showProgress () 


interactor.signUp(username, phoneNumber, password, this) 


} 


interactor.persistAccessToken (preferences) 
interactor.persistUserDetails (preferences) 
view. hideProgress () 
view.navigateToHome () 


override fun onAuthError() { 
view. hideProgress () 
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view. showAuthError () 


上 X SignUpPresenterimpl 类 实现 了 SignUpPresenter .  SignUplnteractor. 
OnSignUpFinishedListener UJ AuthInteractor.onAuthFinishedListener 接口 , 因而 针对 多 个 
所 需 的 函数 提供 了 相关 实现 。 此 类 函数 包括 onSuccess(). onError). onUsernameError(). 
onPasswordError() ~ onPhoneNumberError() ~ executeSignUp(String, String, String) ~ 
onAuthSuccess() fll! onAuthError().. SignUpPresenterImpl 接收 单一 参数 作为 其 主 构造 函数 ， 
对 应 参数 应 为 SignUpView 类 型 。 

在 SignUpView 开始 处 理 用 户 的 注册 操作 时 ,executeSignUp(String, String, String) PK% 
将 被 调用 。 当 用 户 注 册 请 求 成 功 后 ，onSuccessO 将 被 调用 ， 该 函数 即刻 调用 交互 器 的 
getAuthorization() EK Xt, 并 获取 新 注册 用 户 的 访问 令 牌 。 若 注册 请 求 失 败 , 则 调用 onError() 
回调 函数 ， 这 将 隐藏 进度 条 ， 并 显示 相应 的 错误 消息 。 

在 提交 用 户 名 、 密 码 或 电话 号 码 过 程 中 出 现 错误 ，onUsernameError0、onPasswordErrorO 
以 及 onPhoneNumberError() 方 法 将 被 调用 ; 相应 地 ， 若 验证 成 功 ，onAuthSuccessO 将 被 调 
用 。 另 外 一 方面 ， 若 验证 失败 ，onAuthErrorO 将 被 调用 。 


3. 创建 注册 视图 

下 面 讨 论 SignUpView 的 构建 过 程 。 首 先 需 要 定义 SignUpView 接口 ， 随 后 令 
SignUpActivity 实现 该 接口 。 需 要 注意 的 是 ， 在 当前 应 用 程序 中 ，SignUpView 定义 为 
BaseView 和 AuthView 的 扩展 。SignUpView 接口 定义 如 下 所 示 : 


package com.example.messenger.ui.signup 


import com.example.messenger.ui.auth.AuthView 
import com.example.messenger.ui.base.BaseView 


interface SignUpView : BaseView, AuthView { 


fun showProgress () 

fun showSignUpError () 
fun hideProgress () 

fun setUsernameError () 
fun setPhoneNumberError () 
fun setPasswordError () 
fun navigateToHome () 
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下 面 调整 当前 项 目 中 的 SignUpActivity 类 ， 进 而 实现 SignUpView， 并 使 用 到 
SignUpPresenter。 将 下 列 代 码 片段 添加 至 SignUpActivity 中 ， 如 下 所 示 : 


package com.example.messenger.ui.signup 


import android.content.Context 

import android.content.Intent 

import android.support.v7.app.AppCompatActivity 
import android.os.Bundle 

import android.view.View 

import android.widget.Button 

import android.widget.EditText 

import android.widget.ProgressBar 

import android.widget.Toast 

import com.example.messenger.R 

import com.example.messenger.data.local.AppPreferences 
import com.example.messenger.ui.main.MainActivity 


class SignUpActivity : AppCompatActivity(), SignUpView, 
View.OnClickListener { 

private lateinit var etUsername: EditText 

private lateinit var etPhoneNumber: EditText 

private lateinit var etPassword: EditText 

private lateinit var btnSignUp: Button 

private lateinit var progressBar: ProgressBar 

private lateinit var presenter: SignUpPresenter 


override fun onCreate(savedInstanceState: Bundle?) ( 
super.onCreate (savedInstanceState) 
setContentView(R.layout.activity sign up) 
presenter - SignUpPresenterImpl (this) 
presenter.preferences - AppPreferences.create (this) 
bindViews () 


override fun bindViews() { 
etUsername = findViewById(R.id.et username) 
etPhoneNumber = findViewById(R.id.et phone) 
etPassword = findViewById(R.id.et password) 
btnSignUp = findViewById(R.id.btn sign up) 
progressBar = findViewById(R.id.progress bar) 
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btnSignUp.setOnClickListener (this) 
} 


override fun showProgress() { 
progressBar.visibility = View.VISIBLE 


} 


override fun hideProgress() { 
progressBar.visibility = View.GONE 


} 
override fun navigateToHome() { 
finish () 
startActivity (Intent (this, MainActivity::class.java) ) 


} 


override fun onClick(view: View) { 
if (view.id == R.id.btn_sign_up) { 
presenter.executeSignUp (etUsername.text.toString(), 
etPhoneNumber.text.toString(), 
etPassword.text.toString()) 


} 


Gi JG setUsernameError(). setPasswordError(), showAuthError(), showSignUpError() 
All getContext() 函 数 添 加 至 SignUpActivity 中 ， 如 下 所 示 : 


override fun setUsernameError() { 
etUsername.error = "Username field cannot be empty" 


override fun setPhoneNumberError() { 
etPhoneNumber.error = "Phone number field cannot be empty" 


} 


override fun setPasswordError() { 
etPassword.error = "Password field cannot be empty" 


override fun showAuthError() { 
Toast.makeText (this, "An authorization error occurred. 
Please try again later.", 
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Toast.LENGTH LONG).show() 
} 


override fun showSignUpError() { 
Toast.makeText (this, "An unexpected error occurred. 
Please try again later.", 
Toast.LENGTH LONG) .show() 
} 


override fun getContext(): Context { 
return this 


} 


至 此 ， 我 们 已 经 完成 了 Messenger 应 用 程序 的 过 半 内 容 ， 剩 余 工作 主要 涉及 主 UI 7; 
面 的 内 容 ， 第 6 章 将 对 此 展开 讨论 。 


$52 本 章 小 结 


本 章 介 绍 了 Messenger Android 应 用 程序 的 开发 过 程 ， 期 间 涉 及 了 大 量 的 话题 ， 包 括 
MVP 模式 ， 并 根据 该 模式 深入 讨论 了 应 用 程序 的 构建 过 程 。 

本 章 深入 分 析 了 响应 式 程序 设计 ， 并 使 用 到 了 RxJava 和 RxAndroid。 其 中 包括 如 何 
利用 OkHttp 和 Retrofit 与 远程 服务 器 进行 通信 , 随后 实现 了 Retrofit 服务 ， 并 与 第 4 章 开 
发 的 Messenger API 进行 通信 。 

第 6 章 将 结束 Messenger 应 用 程序 的 开发 之 旅 。 


第 6 章 构建 MessengerAndroid App (第 2 部 分 ) 


第 5 章 讨 论 了 Messenger 应 用 程序 开发 , 深度 讲解 了 Kotlin 和 Android 相关 内 容 , 其 
中 涉及 MVP 模式 ， 以 及 如 何 利用 该 模式 创建 功能 强大 的 Android 应 用 程序 。 除 此 之 外 ， 
第 5 章 还 介绍 了 响应 式 程序 设计 ， 以 及 如 何在 应 用 程序 中 使 用 RxJava 和 RxAndroid。 关 
于 与 远程 服务 器 之 间 的 通信 方式 ， 第 5 章 还 讲解 了 OkHttp 和 Retrofit， 并 实现 了 全 功能 
的 Retrofit 服务 ， 以 及 Messenger API 之 间 的 通信 。 在 将 Android 和 Kotlin 进行 有 效 的 整 
合 后 ， 我 们 针对 Messenger 应 用 程序 创建 了 登录 和 注册 用 户 界面 。 

本 章 将 结束 Messenger 应 用 程序 的 开发 之 旅 ， 期 间 主 要 涉及 以 下 内 容 : 
OQ 与 应 用 程序 配置 协同 工作 。 
Q 与 ChatKit 协 同 工 作 。 
Q Android 应 用 程序 测试 机 制 。 
Q 执行 后 台 任 务 。 
下 面 首先 考察 主 UI。 


6.1 创建 主 UI 


与 登录 UI 和 注册 UI 类 似 ， 我们 也 将 对 主 UI 构建 模型 、 视 图 以 及 presenter。 另 外 ， 
对 于 前 两 个 视图， 本章 解 释 其 中 的 一 些 新 概念 ， 具 体 实 现 过 程 将 不 再 袭 述 。 


6.1.1 创建 MainView 


在 讨论 主 视图 之 前 ， 下 面 首先 介绍 一 下 将 要 构建 的 用 户 界面 。 一 种 较 好 的 方法 是 利 
用 字面 方式 描述 MainView 的 各 项 功能 ， 如 下 所 示 : 

Q 主 视图 可 使 登录 用 户 创建 新 的 会 话 。 

OQ 主 视图 可 显示 当前 登录 用 户 的 联系 方式 (在 当前 应 用 程序 中 ， 显 示 Messenger 

平台 上 所 有 注册 用 户 列 表 ) 。 

O 用 户 可 直接 从 MainView 中 访问 设置 页 面 。 

口 用 户 可 直接 从 MainView 中 注销 应 用 程序 。 

下 面 简要 地 介绍 一 下 MainView 的 功能 。 为 了 更 加 清晰 地 描述 MainView， 图 6.1 显 
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示 了 其 示意 图 


o 


MainActivity 
会 话 1 联系 方式 1 
会 话 2 联系 方式 2 
EE 联系 方式 3 
ia eel ELI 联系 方式 4 


启动 MainActivity 


[—————————— gi 
© 单 击 新 会 话 按钮 


会 话 屏幕 联系 方式 屏幕 


图 6.1 MainView 示意 图 


从 图 6.1 中 可 以 看 到 ，MainActivity 向 用 户 泻 染 了 两 个 完全 独立 的 视图 ， 第 一 个 视图 
是 绘画 视图 ， 第 二 个 视图 是 联系 方式 视图 。 对 此 ， 一 种 较 好 的 实现 是 在 MainActivity 中 
使 用 应 用 片段 (fragment〉， 即 会 话 片 段 和 联系 方式 片段 。 

在 明晰 了 MainView 所 包含 的 内 容 后 ， 则 需要 定义 需要 的 接口 ， 并 声明 MainView 的 
行为 。MainView 接口 的 定义 如 下 所 示 : 


package com.example.messenger.ui.main 
import com.example.messenger.ui.base.BaseView 


interface MainView : BaseView ( 
fun showConversationsLoadError () 
fun showContactsLoadError() 
fun showConversationsScreen() 
fun showContactsScreen() 
fun getContactsFragment(): MainActivity.ContactsFragment 
fun getConversationsFragment(): MainActivity.ConversationsFragment 
fun showNoConversations() 
fun navigateToLogin() 
fun navigateToSettings() 
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MainView 的 实现 将 通过 MainActivity 予以 保存 ， 以 供 后 续 使 用 。 下 面 将 处 理 


MainInteractor. 


6.1.2 创建 Mainlnteractor 


用 户 应 可 在 Messenger 平台 上 查看 其 他 用 户 ( 的 联系 方式 ) ， 及 其 在 主屏 幕 中 的 活动 
会 话 。 除 此 之 外 ， 用 户 还 应 可 直接 从 主屏 幕 中 执行 注销 操作 。 对 此 ，MainInteractor 需要 
加 载 联系 方式 、 加 载 会 话 并 执行 注销 操作 。 下 列 代码 表示 为 MainInteractor 接口 定义 ， 同 


时 应 确保 将 其 与 com.example.messenger.ui.main 包 中 的 其 他 Main 文件 进行 整合 。 


package com.example.messenger.ui.main 


import com.example.messenger.data.vo.ConversationListVO 
import com.example.messenger.data.vo.UserListVO 


interface MainInteractor { 
interface OnConversationsLoadFinishedListener ( 
fun onConversationsLoadSuccess ( 
conversationsListVo: ConversationListVO) 
fun onConversationsLoadError() 
interface OnContactsLoadFinishedListener ( 


fun onContactsLoadSuccess(userListVO: UserListVO) 
fun onContactsLoadError () 


interface OnLogoutFinishedListener { 
fun onLogoutSuccess () 


} 


fun loadContacts ( 
listener: MainInteractor.OnContactsLoadFinishedListener) 


fun loadConversations ( 
listener: MainInteractor.OnConversationsLoadFinishedListener) 


fun logout (listener: MainInteractor.OnLogoutFinishedListener) 
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代码 向 MainInteractor 接口 整合 添加 了 OnConversationsLoadFinishedListener 、 
OnContactsLoadFinishedListener 以 及 OnLogoutFinishedListener 接口 ， 且 为 须 由 MainPresenter 
实现 的 全 部 接口 。 另 外 , 无 论 会 话 加 载 、 联 系 方式 加 载 或 用 户 注销 操作 成 功 与 否 , presenter 
中 的 回调 函数 均 不 可 或 缺 ， 进 而 可 执行 相关 动作 。 

包含 了 《〈 实 现 后 的 ) loadContacts() 方 法 的 MainInteractorImpl 类 如 下 所 示 : 


package com.example.messenger.ui.main 


import android.content.Context 

import android.util.Log 

import com.example.messenger.data.local.AppPreferences 

import com.example.messenger.data.remote.repository.ConversationRepository 
import com.example.messenger.data.remote.repository. 
ConversationRepositoryImpl 

import com.example.messenger.data.remote.repository.UserRepository 
import com.example.messenger.data.remote.repository.UserRepositoryImpl 
import io.reactivex.android.schedulers.AndroidSchedulers 

import io.reactivex.schedulers.Schedulers 


class MainInteractorImpl(val context: Context) : MainInteractor ( 


private val userRepository: UserRepository = 
UserRepositoryImpl (context) 

private val conversationRepository: ConversationRepository = 
ConversationRepositoryImpl (context) 

override fun loadContacts (listener: 
MainInteractor.OnContactsLoadFinishedListener) { 


下 面 加 载 Messenger API 平 台中 的 全 部 注册 用 户 , 这 一 类 用 户 可 与 当前 登录 用 户 进行 
通信 ， 如 下 所 示 : 

userRepository.all() 

. subscribeOn (Schedulers.io()) 


-observeOn (AndroidSchedulers.mainThread () ) 
.subscribe({ res -> 


当前 ， 联 系 方式 被 成 功 地 载 入 。 通 过 作为 参数 传递 的 API 响应 数据 ， 
onContactsLoadSuccess() 将 被 调用 ， 如 下 所 示 : 


listener.onContactsLoadSuccess(res) }, 


{ error -> 
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如 果 联 系 方式 加 载 失 败 ，onContactsLoadError0 将 被 调用 ， 如 下 所 示 


listener.onContactsLoadError () 
error.printStackTrace() }) 


} 
} 
loadContacts() f] H] UserRepository 加 载 Messenger 平台 上 现 有 的 用 户 列 表 。 如 果 检 索 
成 功 ， 监 听 器 的 onContactsLoadSuccess0 将 被 打通 ， 其 中 ， 载 入 的 用 户 列表 将 作为 参数 予 
以 传递 。 否 则 ，onContactsLoadError0 将 被 调用 ， 同 时 输出 错误 消息 。 
当前 ，MainInteractorImpl 尚未 实现 ， 还 需 添 加 loadConversations0 和 logoutO 函 数 。 
下 列 代码 片段 定义 了 这 两 个 函数 ， 随 后 可 将 其 添加 至 MainInteractorImpl 中 。 


override fun loadConversations( 
listener: MainInteractor.OnConversationsLoadFinishedListener) ( 


该 函数 通过 会 话 存 储 库 实例 ， 检 索 当 前 登录 用 户 的 所 有 会 话 ， 如 下 所 示 : 


conversationRepository.all() 
-SubscribeOn (Schedulers.io()) 
-observeOn (AndroidSchedulers.mainThread()) 
.Subscribe(( res -> listener.onConversationsLoadSuccess(res) }, 
{ error -> 
listener.onConversationsLoadError () 
error.printStackTrace() }) 


} 


override fun logout ( 
listener: MainInteractor.OnLogoutFinishedListener) { 


注销 操作 将 从 共享 预 置 文件 中 清空 用 户 数 据 ， 并 调用 监听 器 的 onLogoutSuccessO 回 
调 函 数 ， 如 下 所 示 : 

val preferences: AppPreferences = AppPreferences.create (context) 

preferences.clear() 

listener.onLogoutSuccess () 

} 

loadConversations0 的 工作 方式 类 似 于 loadContacts0, 唯一 差别 在 于 ,ConversationRepository 
用 于 检索 当前 用 户 包 含 的 活动 会 话 ， 而 非 联系 方式 列表 。logoutO 只 是 简单 地 清空 应 用 程 
序 所 用 的 预 置 文件 ， 并 移 除 当前 登录 用 户 的 数据 。 随 后 ，OnLogoutFinishedListener 提供 
的 onLogoutSuccess() 方 法 将 被 调用 。 
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MainInteractorImpl 类 定义 暂 告 一 段落 ， 下 面 将 实现 MainPresenter。 
6.1.3 创建 MainPresenter 


像 以 往 一 样 ， 首 先 需 要 定义 一 个 presenter 接口 ， 进 而 定义 presenter 实现 类 所 需 的 函 
数 。MainPresenter 接口 定义 如 下 所 示 : 


package com.example.messenger.ui.main 


interface MainPresenter { 
fun loadConversations() 
fun loadContacts() 
fun executeLogout () 


) 

loadConversations(). loadContacts()#il executeLogout() FK ZUM MainView 被 调用 ， 且 
需要 由 MainPresenterImpl 类 予以 实现 。 下 列 代 码 显示 了 MainPresenterImpl 类 定义 ， 其 中 
包含 了 相关 属性 ， 以 及 onConversationsLoadSuccess0 和 onConversationsLoadError() 方 法 。 


package com.iyanuadelekan.messenger.ui.main 


import com.iyanuadelekan.messenger.data.vo.ConversationListVO 
import com.iyanuadelekan.messenger.data.vo.UserListVO 


class MainPresenterImpl(val view: MainView) : MainPresenter, 
MainInteractor.OnConversationsLoadFinishedListener, 
MainInteractor.OnContactsLoadFinishedListener, 
MainInteractor.OnLogoutFinishedListener ( 


private val interactor: MainInteractor = MainInteractorImpl 
(view.getContext ()) 


override fun onConversationsLoadSuccess (conversationsListVo: 
ConversationListVO) { 


下 列 代码 负责 检测 当前 登录 用 户 是 否 包含 活动 会 话 。 


if (!conversationsListVo.conversations.isEmpty()) { 
val conversationsFragment = view.getConversationsFragment () 
val conversations - conversationsFragment.conversations 
val adapter - conversationsFragment.conversationsAdapter 
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conversations.clear() 
adapter.notifyDataSetChanged() 


在 从 API 中 检索 到 会 话 后 ,可 将 每 个 会 话 添加 至 ConversationFragment 的 会 话 列表 中 ， 
在 加 入 每 项 内 容 后， 会 话 适 配器 将 被 通知 ， 如 下 所 示 : 


conversationsListVo.conversations.forEach { contact -> 
conversations.add (contact) 
adapter.notifyItemInserted(conversations.size - 1) 
) 
) else ( 
view.showNoConversations() 
) 
) 


i 


override fun onConversationsLoadError() { 
view. showConversationsLoadError () 
} 

} 

除 此 之 外 ， 还 需要 向 MainPresenterlmpl i 加 onContactsLoadSuccess() ~ 
onContactsLoadError() 、 onLogoutSuccess() 、 loadConversations() 、 loadContacts( 和 
executeLogout()P Zi, W Fr: 

override fun onContactsLoadSuccess(userListVO: UserListVO) { 

val contactsFragment = view.getContactsFragment () 


val contacts = contactsFragment.contacts 
val adapter = contactsFragment.contactsAdapter 


下 列 代码 负责 清空 联系 方式 列表 中 所 加 载 的 联系 方式 ， 并 通知 适配器 数据 已 产生 变 
化 ， 如 下 所 示 : 


contacts.clear() 
adapter.notifyDataSetChanged() 


下 面 将 从 API 中 检索 到 的 每 项 联系 方式 添加 至 ContactsFragment 的 联系 列表 中 ， 
每 项 内 容 被 添加 后 ， 联 系 方式 适配器 将 被 通知 ， 如 下 所 示 : 


userListVO.users.forEach { contact -> 


B 


contacts.add (contact) 
contactsFragment.contactsAdapter.notifyltemInserted (contacts.size-1) 


) 
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override fun onContactsLoadError() { 
view.showContactsLoadError () 


override fun onLogoutSuccess() { 
view.navigateToLogin() 


} 


override fun loadConversations() { 
interactor.loadConversations (this) 


override fun loadContacts() { 
interactor.loadContacts (this) 


override fun executeLogout() { 
interactor. logout (this) 


} 


至 此 ， 我 们 已 成 功 地 创建 了 MainInteractor 和 MainPresenter， 下 面 将 完成 MainView 


6.1.4 封装 MainView 


首先 需要 对 activity main.xml 布局 文件 进行 适当 调整 ， 如 下 所 示 : 


<?xml version-"1.0" encoding-"utf-8"?» 
«android.support.design.widget.CoordinatorLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
xmlns:tools-"http://schemas.android.com/tools" 
android:layout width-"match parent" 
android:layout height-"match parent" 
tools:context=".ui.main.MainActivity"> 
<LinearLayout 
android: id="@tid/1l1_ container" 
android:layout width-"match parent" 
android:layout height-"match parent" 
android:orientation-"vertical"/» 
</android.support.design.widget .CoordinatorLayout> 


在 布局 文件 的 根 视 图 中 ， 设 置 了 单一 的 LinearLayout. HH, ViewGroup 设置 为 会 话 
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和 联系 方式 片段 的 容器 。 关 于 会 话 和 联系 方式 片段 ， 需 要 对 其 构建 需要 的 布局 ， 并 在 项 
目的 布局 resource 目录 中 生成 fagment_conversations.xml 布局 文件 ， 如 下 所 示 : 


<?xml version-"1.0" encoding="utf-8"?> 
Xandroid.support.design.widget.CoordinatorLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"match parent" 
android:layout height-"match parent" 
xmlns:app-"http://schemas.android.com/apk/res-auto"» 
<android.support.v7.widget .RecyclerView 
android:id="@+id/rv_conversations" 
android:layout width="match parent" 
android:layout height="match parent"/> 
<android. support .design.widget.FloatingActionButton 
android:id="@t+id/fab contacts" 
android: layout_width="wrap_ content" 
android: layout_height="wrap content" 
android:layout margin="@dimen/default margin" 
android: src="@android:drawable/ic menu edit" 
app:layout anchor="@id/rv conversations" 
app: layout_anchorGravity="bottom| right] end"/> 
</android.support.design.widget .CoordinatorLayout> 


这 里 ， 在 CoordinatorLayout 根 视 图 中 使 用 了 两 个 子 视图 ， 分 别 是 RecyclerView 和 
FloatingActionButton. RecyclerView 是 一 个 Android 微 件 , 它 被 用 作 显 示 大 量 数据 的 容器 ， 
通过 维护 有 限 的 视图 数量 ， 可 以 有 效 地 遍历 这 些 数据 。 由 于 向 项 目 中 的 build.gradle 模块 
脚本 中 加 入 了 RecyclerView 依赖 关系 ， 因 而 此 处 需要 使 用 到 该 微 件 ， 如 下 所 示 : 


implementation 'com.android.support:recyclerview-v7:26.1.0"' 


鉴于 使 用 了 RecyclerView 微 件 ， 因 而 需要 针对 每 个 RecyclerView 微 件 创建 相应 的 视 
图 容器 布局 。 针 对 于 此 ， 可 在 布局 resource 目录 中 生成 vh_contacts.xml 文件 和 
vh conversations.xml 文件 。 

vh contacts.xml 布局 文件 如 下 所 示 : 

«?xml version-"1.0" encoding-"utf-8"?» 

<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 


android:orientation-"vertical" android:layout width-"match parent" 
android:id-"G*id/ll container" 


android:layout height-"wrap content"» 
<LinearLayout 
android:layout width-"match parent" 
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android:layout height-"wrap content" 
android:orientation-"vertical" 
android:padding="@dimen/default padding"> 
<LinearLayout 
android:layout width-"match parent" 
android:layout height-"wrap content" 
horizontal"> 


android: orientation= 
<TextView 
android: id="@+tid/tv username" 
android: layout_width="wrap_ content" 
android: layout_height="wrap_ content" 
android: textSize="18sp" 
android: textStyle="bold"/> 
<LinearLayout 
android: layout width="0dp" 
android: layout_height="wrap_ content" 
android: layout_weight="1" 
android: gravity="end"> 
<TextView 
android:id="@+id/tv phone" 
android:layout width="wrap content" 
android: layout_height="wrap_ content" 
android: layout_marginLeft="@dimen/default_margin" 
android: layout_marginStart="@dimen/default_margin"/> 
</LinearLayout> 
</LinearLayout> 
<TextView 
android:id="@tid/tv_status" 
android: layout_width="wrap_ content" 
android: layout_height="wrap_content"/> 
</LinearLayout> 
<View 
android:layout width="match parent" 
android: layout_height="1dp" 
android: background="#e8e8e8"/> 
</LinearLayout> 


vh conversations.xml 布局 文件 包含 了 以 下 代码 : 


<?xml version-"1.0" encoding-"utf-8"?» 

<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" android:layout width-"match parent" 
android:id-"G*id/1ll container" 
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android:layout height-"wrap content"» 
<LinearLayout 
android:layout width="match parent" 
android: layout_height="wrap_ content" 
android:orientation-"vertical" 
android:padding="@dimen/default padding"> 
<TextView 
android:id="@+id/tv username" 
android:layout width="wrap content" 
android:layout height-"wrap content" 
android:textStyle-"bold" 
android:textSize-"18sp"/» 
<TextView 
android:id="@+id/tv preview" 
android:layout width="wrap content" 
android: layout_height="wrap_content"/> 
</LinearLayout> 
<View 
android:layout width="match parent" 
android:layout height="1dp" 
android:background="#e8e8e8"/> 
</LinearLayout> 


Android 开发 参考 中 提 到 : 浮动 按钮 多 用 于 特定 的 提示 类 型 ， 并 通过 浮动 于 UI 上 方 
的 圆 形 图 标 加 以 区 分 ， 同 时 包含 了 与 变形 、 启 动 以 及 移动 锚 点 相关 的 特殊 的 运动 行为 。 
这 里 , 我 们 可 使 用 FloatingActionButton 微 件 一 一 之 前 曾 向 项 目的 build.gradle 脚本 中 添加 
了 Android 设计 库 依 赖 关 系 ， 如 下 所 示 : 


implementation 'com.android.support:design:26.1.0' 


在 包含 了 下 列 XML 文件 的 resource 布局 目录 中 ， 创 建 fagment contacts.xml 布局 文件 。 


<?xml version-"1.0" encoding-"utf-8"?» 
<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" android:layout width-"match parent" 
android:layout height="match parent"» 
<android.support.v7.widget .RecyclerView 
android: id="@+id/rv_contacts" 
android:layout width-"match parent" 
android:layout height-"match parent"/» 
</LinearLayout> 


下 面 完成 MainActivity 类 定义 ， 其 中 涉及 了 较 多 内 容 。 首 先 ， 需 要 声明 所 需 的 相关 类 ; 其 
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次 , 还 应 实现 下 列 方法 : bindViews(). showConversationsLoadError(). showContactsLoadError() . 
showConversationsScreen(). showContactsScreen(). getContext(). getContactsFragment(), 
getConversationsFragment(). navigateToLogin()#ll navigateToSettings0。 最 后 ， 还 需要 定义 
ConversationsFragment 和 ContactsFragment 类 。 

下 面 先 向 MainActivity 中 加 入 ConversationsFragment 和 ContactsFragment。 下 列 代码 
定义 了 ConversationsFragment， 将 其 添加 至 MainActivity 中 。 


//ConversationsFragment class extending the Fragment class 
class ConversationsFragment : Fragment(), View.OnClickListener ( 


private lateinit var activity: MainActivity 

private lateinit var rvConversations: RecyclerView 
private lateinit var fabContacts: FloatingActionButton 
var conversations: ArrayList«ConversationVO» = ArrayList() 
lateinit var conversationsAdapter: ConversationsAdapter 


当 ConversationsFragment 的 用 户 实例 首次 被 绘制 时 ， 将 调用 下 列 方法 : 


override fun onCreateView(inflater: LayoutInflater, container: 
ViewGroup, savedInstanceState: Bundle?): View? ( 

// fragment layout inflation 

val baseLayout - 

inflater.inflate(R.layout.fragment conversations, 

container, false) 


// Layout view bindings 
rvConversations - baseLayout.findViewById(R.id.rv conversations) 
fabContacts = baseLayout.findViewById(R.id.fab contacts) 


conversationsAdapter - ConversationsAdapter( 
getActivity(), conversations) 


// Setting the adapter of conversations recycler view to 
// created conversations adapter 
rvConversations.adapter = conversationsAdapter 


下 面 设置 会 话 回收 布局 管理 器 ， 并 考察 线性 布局 管理 器 的 查看 方式 ， 如 下 所 示 : 


rvConversations.layoutManager - 
LinearLayoutManager (getActivity () .baseContext) 
fabContacts.setOnClickListener (this) 

return baseLayout 
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override fun onClick(view: View) { 
if (view.id == R.id.fab contacts) { 
this.activity.showContactsScreen() 


} 


fun setActivity(activity: MainActivity) { 
this.activity = activity 
} 
} 


ConversationsFragment 包含 了 一 个 RecyclerView 布局 元 素 ， 并 需要 使 用 到 适配器 ， 
以 提供 数据 集 到 视图 〈 显 示 于 RecyclerView 中 ) 之 间 的 绑 定 。 简 而 言 之 ，RecyclerView 
使 用 一 个 Adapter, 并 为 所 显示 的 视图 提供 数据 。 作为 ConversationsFragment HIREK ON 
部 类 ) ， 下 列 代码 显示 了 ConversationsAdapter 类 定义 。 

class ConversationsAdapter (private val context: 

Context, private val dataSet: List<ConversationVO>) : 


RecyclerView.Adapter<ConversationsAdapter.ViewHolder>(), 
ChatView.ChatAdapter { 


val preferences: AppPreferences = 
AppPreferences.create (context) 


override fun onBindViewHolder (holder: ViewHolder, position: 
int) t 
val item = dataSet[position] // get item at current position 
val itemLayout = holder.itemLayout // bind view holder layout 
// to local variable 


itemLayout.findViewById«TextView» (R.id.tv username) .text = 
item.secondPartyUsername 

itemLayout . findViewById<TextView>(R.id.tv_preview) .text = 
item.messages[item.messages.size - 1] .body 


下 列 代码 设置 itemLayout 的 View.OnClickListener. 


itemLayout.setOnClickListener { 
val message = item.messages[0] 
val recipientId: Long 


recipientId = if (message.senderId == 
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preferences.userDetails.id) ( 
message.recipientid 

} else { 
message.senderId 


j 


navigateToChat (item.secondPartyUsername, 
recipientId, item.conversationId) 


override fun onCreateViewHolder(parent: ViewGroup, 
viewType: Int): ViewHolder { 


下 列 代码 创建 ViewHolder 布局 。 


val itemLayout = LayoutInflater.from(parent.context) 
.inflate(R.layout.vh conversations, null, false) 
-findViewById«LinearLayout» (R.id.ll container) 


return ViewHolder (itemLayout) 


override fun getItemCount(): Int { 
return dataSet.size 


override fun navigateToChat (recipientName: String, 
recipientId: Long, conversationId: Long?) ( 
val intent - Intent(context, ChatActivity::class.java) 
intent.putExtra ("CONVERSATION ID", conversationId) 
intent .putExtra ("RECIPIENT ID", recipientId) 
intent .putExtra ("RECIPIENT NAME", recipientName) 


context.startActivity (intent) 


class ViewHolder(val itemLayout: LinearLayout) : 
RecyclerView.ViewHolder (itemLayout) 


} 


当 创建 回收 视图 适配器 时 ， 一 些 较为 重要 的 方法 需要 提供 相应 的 自 定 义 实现 ， 其 中 包 
括 onCreateViewHolder0、onBindViewHolder0 和 getItemCount0 方 法 。 当 回收 视图 需要 一 个 
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新 的 视图 容器 实例 时 ，onCreateViewHolder0 将 被 调用 。 回 收视 图 调用 onBindViewHolder(), 
进而 显示 特定 位 置 数据 集中 的 数据 。 调 用 getItemCount0 将 得 到 数据 集中 的 数据 数量 。 
ViewHolder 用 于 描述 正在 使 用 的 项 目 视 图 , 以 及 RecyclerView 中 与 其 位 置 相 关 的 元 数据 。 


O 注意 : 
内 部 类 表示 为 误 套 于 另 一 个 类 中 的 类 


在 理解 了 ConversationsFragment 的 含义 后 ， 下 面 讨 论 其 实现 过 程 。 首 先 将 
ContactsFragment 类 添加 至 MainActivity 中 ， 如 下 所 示 : 


class ContactsFragment : Fragment() ( 


private lateinit var activity: MainActivity 

private lateinit var rvContacts: RecyclerView 
var contacts: ArrayList<UserVO> = ArrayList() 
lateinit var contactsAdapter: ContactsAdapter 


override fun onCreateView(inflater: LayoutInflater, 

container: ViewGroup, savedInstanceState: Bundle?): View? ( 
val baseLayout = inflater.inflate(R.layout.fragment contacts, 
container, false) 
rvContacts = baseLayout.findViewById(R.id.rv contacts) 
contactsAdapter = ContactsAdapter(getActivity(), contacts) 


rvContacts.adapter - contactsAdapter 
rvContacts.layoutManager - 
LinearLayoutManager (getActivity () .baseContext) 


return baseLayout 


} 


fun setActivity(activity: MainActivity) { 
this.activity = activity 
lj 
) 
相信 读者 已 经 意识 到 , ContactsFragment 使 用 RecyclerView 向 应 用 程序 用 户 显示 联系 
方式 视图 元 素 ， 这 一 点 与 ConversationsFragment 十 分 相似 。ContactsAdapter 则 表示 为 
RecyclerView 对 应 的 适配器 类 。 作为 ContactsFragment 的 内 部 类 ，ContactsAdapter 类 定义 
如 下 所 示 : 
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class ContactsAdapter(private val context: Context, 
private val dataSet: List«UserVO») : 
RecyclerView.Adapter«ContactsAdapter.ViewHolder»(), 
ChatView.ChatAdapter { 


override fun onCreateViewHolder(parent: ViewGroup, 
viewType: Int): ViewHolder ( 
val itemLayout = LayoutInflater.from(parent.context) 
.inflate(R.layout.vh contacts, parent, false) 
val llContainer = itemLayout .findViewById<LinearLayout> 
(R.id.ll container) 


return ViewHolder (11Container) 


override fun onBindViewHolder(holder: ViewHolder, position: Int) ( 
val item = dataSet[position] 
val itemLayout = holder.itemLayout 


itemLayout . findViewById<TextView>(R.id.tv username).text = 


item.username 
itemLayout . findViewById<TextView>(R.id.tv_phone) .text = 


item. phoneNumber 
itemLayout . findViewById<TextView>(R.id.tv_status) .text = item.status 


itemLayout.setOnClickListener { 
navigateToChat (item.username, item.id) 


} 


override fun getItemCount(): Int { 
return dataSet.size 


override fun navigateToChat (recipientName: String, 
recipientId: Long, conversationId: Long?) { 


val intent - Intent(context, ChatActivity::class.java) 
intent.putExtra("RECIPIENT ID", recipientId) 
intent.putExtra("RECIPIENT NAME", recipientName) 


context.startActivity (intent) 
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class ViewHolder(val itemLayout: LinearLayout) : 
RecyclerView.ViewHolder (itemLayout) 
) 


截至 目前 ， 一 切 均 工作 正常 。 下 面 考察 MainActivity 中 的 相关 属性 和 方法 ， 并 将 属 
性 定义 添加 至 MainActivity 类 的 开始 处 ， 如 下 所 示 : 


private lateinit var llContainer: LinearLayout 
private lateinit var presenter: MainPresenter 


// Creation of fragment instances 
private val contactsFragment - ContactsFragment () 
private val conversationsFragment = ConversationsFragment () 


接 下 来 ，onCreate() 修 改 方法 以 体现 相关 变化 ， 如 下 所 示 : 


override fun onCreate(savedInstanceState: Bundle?) ( 
super.onCreate (savedInstanceState) 
setContentView(R.layout.activity main) 
presenter - MainPresenterImpl (this) 


conversationsFragment.setActivity (this) 
contactsFragment.setActivity (this) 


bindViews () 
showConversationsScreen () 


} 

随后 ， 向 MainActivity 中 添加 bindViews() 、 showConversationsLoadError() 、 
showContactsLoadError() 、showConversationsScreen0 和 showContactsScreen() 方 法 ， 如 下 
所 示 : 


override fun bindViews() { 
llContainer = findViewById(R.id.ll container) 


override fun onCreateOptionsMenu (menu: Menu?): Boolean { 
menuInflater.inflate(R.menu.main, menu) 
return super.onCreateOptionsMenu (menu) 


} 


override fun showConversationsLoadError() { 
Toast.makeText (this, "Unable to load conversations. 
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Try again later.", 
Toast.LENGTH LONG).show() 


override fun showContactsLoadError() { 
Toast.makeText(this, "Unable to load contacts. Try again later.", 
Toast.LENGTH LONG).show() 

} 


下 面 利用 ConversationsFragment 蔡 换 活动 容器 中 的 片段 ， 如 下 所 示 ; 


override fun showConversationsScreen() { 
val fragmentTransaction = fragmentManager.beginTransaction() 
fragmentTransaction.replace(R.id.ll container, conversationsFragment) 
fragmentTransaction.commit () 


// Begin conversation loading process 
presenter. loadConversations () 


supportActionBar?.title = "Messenger" 
supportActionBar?.setDisplayHomeAsUpEnabled (false) 


override fun showContactsScreen() { 
val fragmentTransaction = fragmentManager.beginTransaction () 
fragmentTransaction.replace(R.id.ll container, contactsFragment) 
fragmentTransaction.commit () 
presenter. loadContacts () 


supportActionBar?.title = "Contacts" 
supportActionBar?.setDisplayHomeAsUpEnabled (true) 
) 


最 后 ,将 showNoConversations() , onOptionsItemSelected(), getContext(), getContactsFragment() 
getConversationsFragment() , navigate ToLogin()fll navigateToSettings() FK 215: J Æ MainActivity 
最 后 ， 如 下 所 示 : 


override fun showNoConversations() { 
Toast.makeText (this, "You have no active conversations.", 
Toast.LENGTH LONG).show() 

} 


override fun onOptionsItemSelected(item: Menultem?): Boolean { 
when (item?.itemId) { 
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android.R.id.home -> showConversationsScreen() 
R.id.action settings -> navigateToSettings() 
R.id.action logout -> presenter.executeLogout () 


return super.onOptionsItemSelected (item) 


} 


override fun getContext(): Context { 
return this 


override fun getContactsFragment(): ContactsFragment { 
return contactsFragment 


override fun getConversationsFragment (): ConversationsFragment { 
return conversationsFragment 


override fun navigateToLogin() { 
startActivity (Intent (this, LoginActivity::class.java) ) 
finish () 


override fun navigateToSettings() { 
startActivity (Intent (this, SettingsActivity::class.java) ) 
} 


读者 应 注意 上 述 代码 片段 中 的 注释 内 容 ， 进 而 深入 理解 相关 操作 。 
6.1.5 创建 MainActivity 菜单 


在 MainActivity 的 onCreateOptionsMenu(Menu) 函 数 中 , 包含 了 尚未 实现 的 菜单 内 容 。 
下 面向 应 用 程序 resource 目录 下 的 menu 包 中 添加 main.xml 文件 ， 对 应 内 容 如 下 所 示 : 


«?xml version-"1.0" encoding="utf-8"?> 
«menu xmlns:android-"http://schemas.android.com/apk/res/android" 
xmlns:app-"http://schemas.android.com/apk/res-auto"» 
«item 
android:id="@+id/action_ settings" 
android:orderInCategory-"100" 
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android:title="@string/action settings" 
app:showAsAction-"never" /» 
«item 
android: id="@+id/action_logout" 
android: orderInCategory="100" 
android:title="@string/action logout" 
app:showAsAction="never" /> 
</menu> 
至 此 ， 我 们 距离 项 目的 完成 更 近 了 一 步 。 下 面 开 始 处 理 聊天 用 户 方面 的 内 容 。 相 应 
Jii, showConversationLoadError()fll showMessageSendError0 分 别 表示 为 对 应 的 函数 和 接 
口 〈 聊 天 机 制 所 处 的 实际 位 置 ) 。 


62 ”创建 聊天 UI 


聊天 UI 需要 显示 活动 会 话 的 消息 线程 ， 并 支持 用 户 向 其 聊天 对 象 发 送 消息 。 本 节 首 
先 创建 显示 于 用 户 的 视图 布局 。 


6.2.1 创建 聊天 布局 


这 里 将 使 用 到 开源 库 ChatKit 构建 聊天 视图 布局 。ChatKit 是 一 个 Android 库 ， 针 对 
Android 项 目 中 的 聊天 用 户 界面 实现 提供 了 灵活 的 组 件 , 同时 还 包含 了 针对 聊天 用 户 界面 
数据 管理 和 自 定义 操作 的 各 种 工具 。 

下 列 代码 (位 于 build.gradle 脚本 文件 中 ) 将 ChatKit 添加 至 Messenger 项 目 中 。 


implementation 'com.github.stfalcon:chatkit:0.2.2' 


如 前 所 述 ，ChatKit 针对 聊天 UI 提供 了 有 效 的 用 户 界面 微 件 ， 例 如 MessagesList 和 
MessageInput。 其 中 ， 微 件 MessagesList 用 于 显示 会 话 线程 中 的 消息 管理 ，MessageInput 
则 用 于 消息 输入 。 除 了 支持 多 种 风格 的 选项 之 外 ，MessageInput 还 支持 简单 的 输入 验证 
处 理 。 

下 面 考察 如 何在 布局 文件 中 使 用 MessagesList 和 MessageInput。 在 com.example. 
messenger.ui 中 创建 chat 包 ， 并 将 空 活动 ChatActivity 添加 至 其 中 。 打 开 ChatActivity 活 
动 布局 文件 (activity_chat.xml 文件 ) 并 添加 下 列 XML AÈ: 


<?xml version-"1.0" encoding="utf-8"?> 
<RelativeLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
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xmlns:app-"http://schemas.android.com/apk/res-auto" 
xmlns:tools-"http://schemas.android.com/tools" 
android:layout width-"match parent" 
android:layout height-"match parent" 
tools:context-"com.example.messenger.ui.chat.ChatActivity"» 
<com.stfalcon.chatkit.messages .MessagesList 
android:id="@+id/messages list" 
android:layout width="match parent" 
android:layout height="match parent" 
android: layout_above="@+id/message_input"/> 
<com.stfalcon.chatkit.messages .MessageInput 
android: id="@t+id/message input" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:layout alignParentBottom="true" 
app: inputHint="@string/hint_enter_a_message" /> 
</RelativeLayout> 


在 上 述 XML 文件 中 可 以 看 到 ， 其 中 使 用 了 ChatKit 中 的 MessagesList 和 MessageInput 


UI 微 件 。MessagesList 和 MessageInput 微 件 位 于 com.stfalcon.chatkit.messages 包 中 。 读 
者 可 打开 布局 设计 窗口 ， 并 以 可 视 化 方式 查看 布局 的 外 观 。 


下 面 考察 ChatView 类 定义 ， 如 下 所 示 : 
package com.example.messenger.ui.chat 
import com.example.messenger.ui.base.BaseView 
import com.example.messenger.utils.message.Message 
import com.stfalcon.chatkit.messages.MessagesListAdapter 
interface ChatView : BaseView { 
interface ChatAdapter { 
fun navigateToChat (recipientName: String, recipientId: Long, 
conversationId: Long? = null) 
} 
fun showConversationLoadError () 


fun showMessageSendError () 


fun getMessageListAdapter(): MessagesListAdapter<Message> 
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在 ChatView 类 中 , 我 们 定义 了 ChatAdapter 接口 , 其 中 包含 了 唯一 的 navigateToChat 
(String，Long，Long) 函 数 。 该 接口 须 通过 将 用 户 导 向 至 ChatView 的 适配器 予以 实现 ,之 
前 定义 的 ConversationsAdapter 和 ContactsAdapter 实现 了 该 接口 。 

若 会 话 和 消息 加 载 失 败 ， 应 分 别 调 用 showConversationLoadError() 和 
showMessageSendError() 函 数 ， 并 显示 相应 的 错误 消息 。 

针对 消息 数据 集 的 管理 ，ChatKit 的 MessagesList UI 微 件 需 要 包含 一 个 
MessagesListAdapter。 当 通过 ChatView 实现 了 函数 getMessageListAdapter() 时 ,该 函数 将 
返回 UI MessagesList 的 MessagesListAdapter。 


6.22 ”准备 聊天 UI 模型 


在 将 消息 添加 至 MessageList 的 MessagesListAdapter 中 时 ， 需 要 实现 对 应 模型 中 的 、 
ChatKit 的 IMessage 接口 。 此 处 将 实现 该 模型 ， 对 此 ， 可 创建 com.example.messenger. 
utils.message 包 ， 并 将 下 列 Message 类 添加 于 其 中 。 


package com.example.messenger.utils.message 


import com.stfalcon.chatkit.commons.models.IMessage 
import com.stfalcon.chatkit.commons.models.IUser 
import java.util.* 


data class Message(private val authorId: Long, private val body: String, 
private val createdAt: Date) : IMessage { 


override fun getId(): String { 
return authorId.toString() 
) 


override fun getCreatedAt(): Date ( 
return createdAt 


} 


override fun getUser(): IUser { 
return Author(authorId, "") 


} 


override fun getText(): String { 
return body 
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除 此 之 外 , 还 需要 定义 Author 类 以 实现 ChatKit 中 的 TUser 接口 。 该 类 的 具体 实现 如 
下 所 示 ; 


package com.example.messenger.utils.message 
import com.stfalcon.chatkit.commons.models.IUser 
data class Author(val id: Long, val username: String) : IUser ( 


override fun getAvatar(): String? ( 
return null 


} 


override fun getName(): String { 
return username 


} 


override fun getId(): String { 
return id.toString() 
} 


} 
Author 类 对 消息 创建 者 的 用 户 信息 建 模 ， 例 如 消息 创建 者 的 名 字 、ID 以 及 昵称 (如 
果 存 在 ) 。 下 面 将 处 理 视 图 和 布局 方面 的 问题 ， 并 实现 ChatInteractor 和 ChatPresenter。 


6.2.3 创建 Chatlnteractor 和 ChatPresenter 


前 述 内 容 讨论 了 presenter 和 交互 器 的 具体 含义 ， 这 里 将 直接 对 其 进行 编码 。 下 列 代 
码 定义 了 ChatInteractor 接口 。 相 应 地 ， 该 接口 以 及 所 有 其 他 的 Chat 文件 均 位 于 


com.example.messenger.ui.chat £f 。 


package com.example.messenger.ui.chat 
import com.example.messenger.data.vo.ConversationVO 


interface ChatInteractor { 


第 6 章 构建 Messenger Android App (第 2 部 分 ) "243。 


interface OnMessageSendFinishedListener { 
fun onSendSuccess() 


fun onSendError() 


} 


interface onMessageLoadFinishedListener { 
fun onLoadSuccess (conversationVO: ConversationVO) 
fun onLoadError () 


fun sendMessage(recipientId: Long, message: String, listener: 
OnMessageSendFinishedListener) 


fun loadMessages (conversationId: Long, listener: 
onMessageLoadFinishedListener) 


) 
下 列 代码 显示 了 基于 ChatInteractor 接口 的 ChatInteractorImpl 类 定义 。 


package com.example.messenger.ui.chat 


import android.content.Context 

import com.example.messenger.data.local.AppPreferences 

import com.example.messenger.data.remote.repository. 
ConversationRepository 

Import com.example.messenger.data.remote.repository. 
ConversationRepositoryImpl 

import com.example.messenger.data.remote.request.MessageRequestObject 
import com.example.messenger.service.MessengerApiService 

import io.reactivex.android.schedulers.AndroidSchedulers 

import io.reactivex.schedulers.Schedulers 


class ChatInteractorImpl(context: Context) : ChatInteractor { 


private val preferences: AppPreferences = AppPreferences.create (context) 
private val service: MessengerApiService = MessengerApiService 
-getInstance|() 
private val conversationsRepository: ConversationRepository - 
ConversationRepositoryImpl (context) 


当 调用 下 列 方法 时 ， 将 加 载 会 话 线程 的 消息 内 容 。 
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override fun loadMessages(conversationId: Long, listener: 
ChatInteractor.onMessageLoadFinishedListener) { 
conversationsRepository.findConversationById (conversationId) 
.subscribeOn (Schedulers.io()) 
-observeOn (AndroidSchedulers.mainThread()) 
-subscribe(( res -> listener.onLoadSuccess (res)], 
{ error -> 
listener.onLoadError () 
error.printStackTrace()]) 


} 
当 调用 下 列 方法 时 ， 将 向 用 户 发 送 一 条 消息 。 


override fun sendMessage(recipientId: Long, message: String, 
listener: ChatInteractor.OnMessageSendFinishedListener) ( 
service.createMessage (MessageRequestObject ( 
recipientId, message), preferences.accessToken as String) 
-SubscribeOn (Schedulers.io()) 
-observeOn (AndroidSchedulers.mainThread()) 
.Subscribe({ -> listener.onSendSuccess()], 
{ error -> 
listener.onSendError () 
error.printStackTrace()]) 
) 
) 


接 下 来 将 处 理 与 ChatPresenter 和 ChatPresenterImpl 相关 的 代码 。 对 于 ChatPresenter, 
需要 定义 一 个 接口 ， 并 声明 两 个 函数 : sendMessage(Long, String) 和 loadMessages(Long). 
ChatPresenter 接口 定义 如 下 所 示 : 


package com.example.messenger.ui.chat 
interface ChatPresenter { 
fun sendMessage(recipientId: Long, message: String) 


fun loadMessages (conversationId: Long) 


) 
ChatPresenter 接口 的 实现 类 如 下 所 示 : 


package com.iyanuadelekan.messenger.ui.chat 
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import android.widget.Toast 

import com.iyanuadelekan.messenger.data.vo.ConversationVO 
import com.iyanuadelekan.messenger.utils.message.Message 
import java.text.SimpleDateFormat 


class ChatPresenterImpl(val view: ChatView) : ChatPresenter, 
ChatInteractor.OnMessageSendFinishedListener, 
ChatInteractor.onMessageLoadFinishedListener { 


private val interactor: ChatInteractor = ChatInteractorImpl 
(view.getContext ()) 


override fun onLoadSuccess(conversationVO: ConversationVO) { 
val adapter = view.getMessageListAdapter () 


// create date formatter to format createdAt dates 
// received from Messenger API 
val dateFormatter = SimpleDateFormat ("yyyy-MM-dd HH:mm:ss") 


下 面 遍 历 从 API 中 加 载 的 会 话 消 息 ， 对 当前 遍历 的 消息 创建 新 的 IMessage XJ $t, Jf 
将 IMessage 添加 至 MessagesListAdapter 的 开始 处 ， 如 下 所 示 : 


conversationVO.messages.forEach { message -> 
adapter.addToStart (Message (message.senderId, message.body, 
dateFormatter.parse (message.createdAt.split(".")[0])), true) 


override fun onLoadError() { 
view. showConversationLoadError () 


override fun onSendSuccess() { 
Toast.makeText (view.getContext(), "Message sent", 
Toast .LENGTH_LONG) . show () 
} 


override fun onSendError() { 
view. showMessageSendError () 


} 


override fun sendMessage(recipientId: Long, message: String) { 
interactor.sendMessage(recipientiId, message, this) 


+246 + 


Kotlin 语言 实例 精 解 


override fun loadMessages(conversationId: Long) { 


interactor.loadMessages (conversationId, this) 


) 
) 


读者 应 留意 上 述 代码 中 的 注释 内 容 ， 从 而 深入 理解 当前 操作 的 具体 含义 。 
下 面 讨 论 ChatActivity， 声 明 所 需 的 属性 并 考察 onCreateQ FR Zt. 
对 此 ， 调 整 ChatActivity 方法 并 包含 以 下 内 容 : 


package com.example.messenger.ui.chat 


import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 


android.content.Context 

android.content.Intent 
android.support.v7.app.AppCompatActivity 
android.os.Bundle 

android.view.MenuItem 

android.widget.Toast 

com.example.messenger.R 
com.example.messenger.data.local.AppPreferences 
com.example.messenger.ui.main.MainActivity 
com.example.messenger.utils.message.Message 
com.stfalcon.chatkit.messages.MessageInput 
com.stfalcon.chatkit.messages.MessagesList 
com.stfalcon.chatkit.messages.MessagesListAdapter 
java.util.* 


class ChatActivity : AppCompatActivity(), ChatView, 
MessageInput.InputListener ( 


private var recipientId: Long = -1 


private lateinit var messageList: MessagesList 


private lateinit var messageInput: MessageInput 


private lateinit var preferences: AppPreferences 


private lateinit var presenter: ChatPresenter 
private lateinit var messageListAdapter: MessagesListAdapter<Message> 


override fun onCreate(savedInstanceState: Bundle?) { 


super.onCreate (savedInstanceState) 


setContentView(R.layout.activity chat) 


supportActionBar?.setDisplayHomeAsUpEnabled (true) 
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supportActionBar?.title = 
intent.getStringExtra ("RECIPIENT NAME") 


preferences - AppPreferences.create (this) 
messageListAdapter = MessagesListAdapter( 
preferences.userDetails.id.toString(), null) 
presenter - ChatPresenterImpl (this) 
bindViews() 


下 面 解 析 源 自 intent 的 额外 包 ( 用 于 启动 ChatActivity ) 。 若 不 存在 由 
CONVERSATION ID 和 RECIPIENT ID 所 标识 的 包 ， 则 返回 默认 值 -1， 如 下 所 示 : 

val conversationId = intent.getLongExtra ("CONVERSATION ID", -1) 

recipientId = intent.getLongExtra ("RECIPIENT ID", -1) 

如 果 conversationId 不 等 于 -1， 那 么 ， 该 conversationld 视 为 有 效 ， 并 加 载 会话 中 的 
消息 ， 如 下 所 示 : 

if (conversationId != -1L) { 

presenter. loadMessages (conversationId) 


} 
} 


} 


上 述 代码 创建 了 recipientId, messageList. messageInput. preferences. presenter 以 及 
messageListAdapter 属性 ， 对 应 类 型 分 别 为 Long 、MessageList 、 MessageInput 、 
AppPreferences, ChatPresenter 和 MessageListAdapter。 其 中 ， 视 图 messageList 用 于 显示 
messageListAdapter 向 其 提供 的 消息 视图 。 onCreate0 中 包含 的 全 部 逻辑 将 处 理 当前 活动 中 
的 视图 初始 化 操作 ， 读 者 应 留意 其 中 的 注释 内 容 。ChatActivity 实现 了 MessageInput. 
InputListener， 实 现 了 该 接口 的 相关 类 须 提供 相应 的 onSubmit0 方 法 。 

当 用 户 提 交 了 包含 MessageInput 的 微 件 后 , MessageInput.InputListener 中 被 覆 写 的 函 
数 将 被 调用 ， 如 下 所 示 : 

override fun onSubmit(input: CharSequence?): Boolean { 

// create a new Message object and add it to the 
// start of the MessagesListAdapter 


messageListAdapter.addToStart (Message ( 
preferences.userDetails.id, input.toString(), Date()), true) 


// start message sending procedure with the ChatPresenter 
presenter.sendMessage(recipientId, input.toString()) 


+248 * Kotlin 语言 实例 精 解 


return true 


} 


onSubmit() #4 MessageInput 所 提交 消息 的 CharSequence， 并 对 此 创建 相应 的 
Message 实例 。 随 后 ， 该 实例 添加 至 MessageList 的 开始 处 ， 即 调用 messageListAdapter. 
addToStart() 并 包含 作为 参数 传递 的 Message 实例 ,在 向 MessageList 添 加 了 生成 的 Message 
后 ，ChatPresenter 实例 用 于 初始 化 针对 服务 器 的 发 送 程 序 。 

下 面 考察 其 他 需要 有 覆 写 的 方法 ， 并 将 showConversationLoadError()、 
showMessageSendError(). getContext()fll getMessageListAdapter() 方 法 添加 至 ChatActivity 
中 ， 如 下 所 示 : 


override fun showConversationLoadError() ( 
Toast.makeText(this, "Unable to load thread. 
Please try again later.", 
Toast.LENGTH LONG).show() 


override fun showMessageSendError() ( 
Toast.makeText (this, "Unable to send message. 
Please try again later.", 
Toast.LENGTH LONG).show() 


override fun getContext(): Context { 
return this 


override fun getMessageListAdapter(): MessagesListAdapter<Message> { 
return messageListAdapter 


) 
最 后 ， 还 需要 覆 写 bindViews(). onOptionsItemSelected()fi! onBackPressed0 方 法 ， 如 
下 所 示 : 
override fun bindViews() { 
messageList = findViewById(R.id.messages list) 
messageInput - findViewById(R.id.message input) 


messageList.setAdapter (messageListAdapter) 
messageInput.setInputListener (this) 


override fun onOptionsItemSelected(item: MenuItem?): Boolean { 
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if (item?.itemId == android.R.id.home) { 
onBackPressed() 


} 


return super.onOptionsItemSelected (item) 


} 


override fun onBackPressed() { 
super .onBackPressed () 
finish () 
} 
当前 ， 一 切 均 故 作 正常 ， 我 们 已 成 功 地 构建 了 Messenger 应 用 程序 中 的 大 部 分 内 容 。 
剩 下 的 工作 则 是 构建 设置 活动 ， 以 使 用 户 能 够 更 新 其 配置 状态 。 


63 ”应 用 程序 设置 


本 节 将 开发 一 个 简单 的 应 用 程序 设置 活动 ， 据 此 ， 用 户 可 更 新 其 配置 状态 。 对 此 ， 
可 在 com.example.messenger.ui 下 生成 新 的 数据 包 ， 同 时 创建 新 的 设置 活动 ， 并 将 该 活动 
命名 为 SettingsActivity。 当 创建 设置 活动 时 ， 可 在 settings 上 单 击 鼠标 右键 ， 在 弹出 的 快 
捷 菜 单 中 选择 New | Activity | Settings Activity 命令 , 输入 新 设置 活动 必要 的 信息 , 例如 活 
动 名 称 和 活动 标题 ， 随 后 单 击 Finish 按钮 。 

在 SettingsActivity 的 创建 过 程 中 ，Android Studio 会 向 当前 项 目 中 添加 多 个 文件 。 除 
此 之 外 ， 新 的 资源 目录 Capp | res | xml) 也 将 添加 至 项 目 中 。 该 目录 中 包含 了 以 下 文件 : 

Q pref data sync.xml 文件 

O pref general.xml 文件 。 

Q pref headers.xml 文件 。 

Q pref notification.xml X fT. 

读者 也 可 选择 删除 pref. notification.xml 和 pref data sync.xml 文件 ， 当 前 项 目 暂 不 会 
使 用 到 这 些 文件 。 下 面 考 察 pref general.xml 文件 ， 如 下 所 示 : 

XPreferenceScreen 

xmlns:android-"http://schemas.android.com/apk/res/android"» 

<SwitchPreference 


android:defaultValue="true" 
android:key="example switch" 


android: summary= 
"QGstring/pref description social recommendations" 
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android 


<!-- NO 
<!—— NO 
its val 
<EditTe 


:title-"Gstring/pref title social recommendations" /> 


TE: EditTextPreference accepts EditText attributes. --> 
TE: EditTextPreference's summary should be set to 

ue by the activity code. --> 

xtPreference 


android:capitalize-"words" 
android:defaultValue="@string/pref default display name" 
android:inputType-"textCapWords" 
android:key-"example text" 

android:maxLines="1" 

android: selectAll0nFocus="true" 
android:singleLine="true" 

android:title="@string/pref title display name" /> 


<!/—— NO 
Users ic 
dismiss 
«!-- NO 
its val 
<ListPr 


TE: Hide buttons to simplify the UI. 
an touch outside the dialog to 
Hes ==> 
TE: ListPreference's summary should be set to 
ue by the activity code. --> 
eference 


android:defaultValue="-1" 
android:entries="@array/pref example list_titles" 
android:entryValues="@array/pref example list values" 
android:key-"example list" 

android:negativeButtonText="@null" 
android:positiveButtonText="@null" 
android:title="@string/pref title add friends to messages" /> 


</PreferenceScreen> 


ER xml 布局 文件 的 根 视图 为 PreferenceScreen。PreferenceScreen 表示 为 Preference 
层次 结构 的 根 。PreferenceScreen 自身 表示 为 一 个 顶级 (top-level) Preferences XE, A 
if Preference 将 被 多 次 使 用 ， 下 面 对 此 加 以 定义 。Preference 表示 为 基本 的 Preference 用 


户 界面 构造 块 ， 
对 于 显示 了 


以 PreferenceActivity 列表 显示 加 以 显示 。 


F PreferenceActivity 中 的 首选 项 及 其 所 关联 的 SharedPreferences( 用 


于 首选 


项 的 存储 和 检索 ), Preference 类 提供 了 相应 的 视图 。 上 述 代码 片段 中 的 SwitchPreference、 
EditTextPreference 以 及 ListPreference 均 为 DialogPreference 的 子 类 ， 同 时 也 是 Preference 
类 的 超 类 。PreferenceActivity 表示 为 某 个 活动 所 需 的 基 类 , 进而 向 用 户 显 示 首 选项 的 层次 


结构 。 
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当前 并 不 需要 使 用 到 pref general.xml 文件 中 的 SwitchPreference、EditTextPreference 


和 ListPreference， 


因而 可 将 其 从 XML 文件 中 移 除 。 此 处 需要 一 个 首选 项 ， 以 使 用 户 可 在 


Messenger 平台 上 更 新 其 状态 。 作 为 一 个 特例 , 目前 尚 不 存在 首选 项 微 件 可 提供 这 一 功能 。 
但 读者 也 不 必 过 分 担心 ， 下 面 将 实现 一 个 自 定义 首选 项 以 完成 这 项 任务 。 该 首选 项 可 命 
名 为 ProfileStatusPreference。 接 下 来 在 settings 包 中 定义 对 应 的 ProfileStatusPreference 类 ， 


如 下 所 示 : 


package com.example.messenger.ui.settings 


import android.content.Context 

import android.preference.EditTextPreference 

import android.text.TextUtils 

import android.util.AttributeSet 

import android.widget.Toast 

import com.example.messenger.data.local.AppPreferences 
import com.example.messenger.data.remote.request. 
StatusUpdateRequestObject 


import com.example.messenger.service.MessengerApiService 
import io.reactivex.android.schedulers.AndroidSchedulers 
import io.reactivex.schedulers.Schedulers 


class ProfileStatusPreference (context: Context, attributeSet: 
AttributeSet) : EditTextPreference(context, attributeSet) ( 


private val service: MessengerApiService = MessengerApiService 


-getInstance() 
private val preferences: AppPreferences = AppPreferences 
-create (context) 


override fun onDialogClosed(positiveResult: Boolean) ( 
if (positiveResult) ( 


下 列 代码 片段 将 ProfileStatusPreference 的 EditText 绑 定 至 etStatus 变量 上 : 


val etStatus = editText 


if (TextUtils.isEmpty(etStatus.text)) ( 

// Display error message when user tries 

// to submit an empty status. 
Toast.makeText (context, "Status cannot be empty.", 
Toast.LENGTH LONG).show() 


。252 。 Kotlin 语言 实例 精 解 


} else { 
val requestObject = 
StatusUpdateRequestObject (etStatus.text.toString()) 


下 面 利 用 MessengerApiService 更 新 用 户 的 状态 ， 如 下 所 示 : 


service.updateUserStatus (requestObject, 
preferences.accessToken as String) 

. subscribeOn (Schedulers.io()) 

-observeOn (AndroidSchedulers.mainThread()) 
-subscribe(( res -> 


如 果 状 态 关 系 成 功 ， 则 存储 更 新 后 的 用 户 信息 ， 如 下 所 示 : 


preferences.storeUserDetails(res) ], 

{ error -> 
Toast.makeText (context, "Unable to update status at the " + 
"moment. Try again later.", Toast.LENGTH LONG) .show() 
error.printStackTrace() }) 


super.onDialogClosed (positiveResult) 

} 

ProfileStatusPreference 类 扩展 了 EditTextPreference。 相 应 地 ，EditTextPreference 表示 为 
支持 EditText 中 字符 串 输入 的 Preference。EditTextPreference 表示 为 一 个 DialogPreference， 
因此 ， 当 单 击 Preference 时 ， 可 向 用 户 显示 一 个 包含 Preference 视图 的 对 话 框 。 当 关闭 
DialogPreference 的 对 话 框 时 ， 其 onDialogClosed(Boolean) 方 法 将 被 调用 。 其 中 ， 当 对 话 
框 利用 正 值 被 关闭 时 ， 正 布尔 值 参数 true 将 被 传递 至 onDialogClosed0 中 ; 相应 地 ， 当 对 
话 框 利用 负 值 被 关闭 时 , false 将 传递 至 onDialogClosed0 中 , 例如 单 击 对 话 框 的 取消 按钮 。 

ProfileStatusPreference 78 *j Y EditTextPreference 的 onDialogClosed0 函 数 。 如 果 该 对 
话 框 利用 正 值 被 关闭 ， 将 对 ProfileStatusPreference 的 EditText 函数 中 的 状态 有 效 性 进行 
检测 。 如 果 状 态 消 息 有 效 ， 该 状态 将 通过 API 更 新 ;否则 将 显示 一 条 错误 消息 。 

在 创建 了 ProfileStatusPreference 后 ， 下 面 返回 至 pref general.xml 文件 ， 并 对 其 进行 
更 新 ， 如 下 所 示 : 


<PreferenceScreen 
xmlns:android="http://schemas.android.com/apk/res/android"> 
Xcom.example.messenger.ui.settings.ProfileStatusPreference 
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android:key-"profile status" 
android:singleLine-"true" 
android:inputType-"text" 
android:maxLines-"1" 
android:selectAllOnFocus-"true" 

android:title-"Profile status" 
android:defaultValue-"Available" 

android:summary-"Set profile status (visible to contacts)."/» 


</PreferenceScreen> 


不 难 发 现 ， 上 述 代码 中 使 用 了 ProfileStatusPreference， 就 像 在 Android 应 用 程序 框架 
中 绑 定 的 任何 其 他 首选 项 一 样 。 
接 下 来 查看 pref headers.xml 文件 ， 如 下 所 示 : 


<preference-headers 
xmlns:android-"http://schemas.android.com/apk/res/android"» 
<!-- These settings headers are only used on tablets. --> 
«header 
android:fragment- 
"com.example.messenger.ui.settings.SettingsActivity 
$GeneralPreferenceFragment" 
android:icon="@drawable/ic info black 24dp" 
android:title="@string/pref header general" /> 
<header 
android: fragment= 
"com.example.messenger.ui.settings.SettingsActivity 
$NotificationPreferenceFragment" 
android:icon="@drawable/ic notifications black 24dp" 
android:title="@string/pref header notifications" /> 
«header 
android:fragment- 
"com.example.messenger.ui.settings.SettingsActivity 
$DataSyncPreferenceFragment" 
android:icon="@drawable/ic sync black 24dp" 
android:title="@string/pref header data sync" /> 
</preference-headers> 


针对 SettingsActivity 中 的 各 种 首选 项 ， 首 选项 头 文件 定义 了 相应 的 数据 头 ， 如 下 所 示 : 


<preference-headers 
xmlns:android="http://schemas.android.com/apk/res/android"> 
<header 

android:fragment= 
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"com.example.messenger.ui.settings.SettingsActivity 

$GeneralPreferenceFragment" 

android:icon="@drawable/ic info black 24dp" 

android:title="@string/pref_header_account" /> 
</preference-headers> 


下 面 考察 SettingsActivity， 如 下 所 示 : 


package com.example.messenger.ui.settings 


import android.content.Intent 

import android.os.Bundle 

import android.preference.PreferenceActivity 
import android.preference.PreferenceFragment 
import android.view.MenuItem 

import android.support.v4.app.NavUtils 
import com.example.messenger.R 


KP, PreferenceActivity 表示 为 应 用 程序 设置 集 ， 如 下 所 示 : 


class SettingsActivity : AppCompatPreferenceActivity() ( 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate (savedInstanceState) 
supportActionBar?.setDisplayHomeAsUpEnabled (true) 


} 


override fun onMenuItemSelected(featureId: Int, item: MenuItem): 
Boolean ( 
val id = item.itemId 


if (id == android.R.id.home) { 
if (!super.onMenuItemSelected(featureId, item)) { 
NavUtils.navigateUpFromSameTask (this) 
} 


return true 


} 


return super.onMenuItemSelected(featureId, item) 


} 
当 相 关 活 动 需要 使 用 到 数据 头 列表 时 ， 下 列 onBuildHeaders0 函 数 将 被 调用 : 


override fun onBuildHeaders (target: List<PreferenceActivity.Header>) 


{ 
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loadHeadersFromResource (R.xml.pref headers, target) 


} 
下 面 的 方法 可 以 防止 恶意 应 用 程序 的 片段 注入 , 且 所 有 未 知 的 片段 均 在 此 处 被 拒绝 。 


override fun isValidFragment (fragmentName: String): Boolean { 


return PreferenceFragment::class.java.name == fragmentName 
| GeneralPreferenceFragment::class.java.name == fragmentName 
) 
下 列 片 段 显 示 了 通用 首选 项 : 


class GeneralPreferenceFragment : PreferenceFragment() { 


override fun onCreate(savedInstanceState: Bundle?) ( 
super.onCreate (savedInstanceState) 


addPreferencesFromResource (R.xml.pref general) 
setHasOptionsMenu (true) 


} 


override fun onOptionsItemSelected(item: MenuItem): Boolean { 
val id = item.itemId 


if (id == android.R.id.home) { 
startActivity(Intent (activity, SettingsActivity::class.java) ) 
return true 

} 

return super.onOptionsItemSelected (item) 

} 
} 
} 


SettingsActivity 扩展 了 AppCompatPreferenceActivity 一 一 该 活动 实现 了 与 AppCompat 
连同 使 用 的 多 个 调用 。SettingsActivity 表示 为 一 个 PreferenceActivity， 并 显示 了 一 组 应 用 
程序 设置 集 。 若 当前 活动 需要 使 用 到 数据 头 列表 时 ，SettingsActivity 的 onBuildHeaders() 
函数 将 被 调用 .isValidFragmentO 则 用 于 阻止 恶意 应 用 程序 向 SettingsActivity 中 注入 片段 。 
若 某 个 片段 有 效 ， 那 么 ，isValidFragmentO 将 返回 true; 否则 返回 false. 

SettingsActivity 中 声明 了 一 个 GeneralPreferenceFragment 类 , 并 对 PreferenceFragment 
进行 扩展 。PreferenceFragment 表示 为 定义 于 Android 应 用 程序 框架 中 的 抽象 类 ， 并 以 列 
表 形 式 显示 了 Preference 实例 的 层次 结构 。 

通过 调用 addPreferencesFromResource(R.xml.pref general), pref general.xml 文件 中 的 
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首选 项 将 被 添加 至 onCreate() 方 法 的 GeneralPreferenceFragment 中 。 

在 对 SettingsActivity 进行 了 上 述 调整 后 ,读者 即 成 功 地 完成 了 Messenger 应 用 程序 的 
设置 工作 。 

在 结束 了 SettingsActivity 后 ， 下 面 将 尝试 运行 Messenger 应 用 程序 。 相 应 地 ， 读 者 可 
在 虚拟 或 物理 设备 上 构建 、 运 行当 前 Messenger 应 用 程序 。 当 应 用 程序 启动 后 , 读者 将 直 
接 转 至 LoginActivity。 

首先 需要 在 Messenger 平 台 上 注册 新 用 户 ,我 们 可 在 SignUpActivity 上 完成 此 项 操作 。 
Hi “DON'T HAVE AN ACCOUNT? SIGN UP!” 按 钮 ， 用 户 将 被 转 至 SignUpActivity, 
如 图 6.2 所 示 。 

在 当前 活动 中 创建 新 用 户 ， 并 输入 popeye 作为 用 户 名 ， 以 及 电话 号 码 和 密码 ， 随 后 
单 击 SIGN UP 按钮 。 此 时 ， 新 用 户 将 在 Messenger 平台 上 注册 ， 对 应 的 用 户 名 为 popeye。 


[= 


当 注 册 结 束 后 ， 用 户 将 被 转 至 MainActivity， 且 会 话 视图 将 被 即刻 显示 ， 如 图 6.3 所 示 。 


“a Q 10:17 % O 10:18 
Messenger Messenger 
popeye 
Username 
1745678946 
Password 
LOGIN 
DON'T HAVE AN ACCOUNT? SIGN UP! 
O D 
图 6.2 注册 页 面 图 6.3 会 话 视图 


由 于 新 注册 用 户 尚 不 包含 任何 活动 对 话 ， 因 而 此 处 将 会 显示 一 条 提示 信息 ， 如 图 6.4 
所 示 。 对 此 ， 需 要 在 Messenger 平台 上 创建 另 一 个 用 户 ， 以 展示 聊天 功能 。 单 击 屏幕 右上 
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处 的 3 个 竖 点 图 标 ， 选 择 logout 命令 并 注销 popeye 账户 。 
当 注 销 用 户 后 , 可 利用 用 户 名 dexter 创建 一 个 新 的 Messenger 账号 。 在 以 dexter 登录 


后 ， 单 击 会 话 视图 右 下 方 的 新 消息 创建 浮动 动作 按钮 ， 随 后 将 显示 联系 方式 视图 ， 如 图 6.5 
所 示 
^ Q 1018 
Messenger : Messenger settings 
logout 
图 6.4 新 注册 用 户 尚 不 包含 任何 活动 对 话 图 6.5 联系 方式 视图 


单 击 popeye 联系 方式 将 打开 ChatActivity， 下 面向 popeye 发 送 消息 。 在 屏幕 右 下 方 
的 消息 输入 框 中 输入 “Hey Popeye!”， 随 后 单 击 Send 按钮 ， 该 消息 将 发 送 至 popeye 处 ， 
如 图 6.6 所 示 。 

当 返 回 至 MainActivity 的 会 话 视图 ， 读 者 将 注意 到 一 个 对 话 项 现在 存在 于 popeye JA 
动 的 对 话 中 ， 如 图 6.7 所 示 。 

下 面 检测 消息 是 否 真正 传送 至 popeye 处 。 注 销 平 台 ， 随 后 以 popeye 身份 登录 。 登录 
后 ， 读 者 将 会 看 到 dexter 启动 的 对 话 ， 如 图 6.8 所 示 。 

RS! 消息 已 被 正确 地 发 送 。 下 面 尝 试 回复 dexter。 打 开会 话 ， 并 向 dexter 发 送 如 图 6.9 
所 示 的 消息 。 
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“a D 10:28 


popeye 


23 November 2017 


Hey Popeye! 


Type a message 7 
4 
eee ere 
QWiE+R T Y Ul Q P 
ASDFGH JKL 


m qu 


图 6.6 将 消息 发 送 至 popeye 


Messenger 


dexter 
Hey Popeye! 


图 6.8 dexter 启动 的 对 话 


Messenger 


popeye 
Hey Popeye! 


图 6.7 对 话 项 存在 于 popeye 启动 的 对 话 中 


23 November 2017 


Hey Popeye! 2228 


How are you Dexter? 


Type a message. NS 


v 


RE 
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图 6.9 回复 dexter 
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在 图 6.9 中 ， 我 们 发 送 了 一 条 简单 的 消息 “How are you Dexter?”。 当 前 ， 需 要 相应 
地 更 新 popeye 的 配置 状态 。 对 此 ， 返 回 至 主 活动 并 访问 设置 活动 〈 单 击 操作 栏 上 的 3 个 
竖 点 形状 的 图 标 ) 。 单 击 启动 设置 显示 中 的 Account 将 显示 通用 首选 项 片段 。 单 击 Profile 
status 首选 项 ， 如 图 6.10 所 示 。 
随后 将 显示 一 个 包含 EditText 的 对 话 框 ， 用 户 可 输入 新 的 配置 状态 。 输 入 所 选 的 状 
态 消息 并 单 击 OK 按钮 ， 如 图 6.11 所 示 。 


€ Account 


Profile status 
Set profile status (visible to contacts) 


Profile status 


CANCEL 


图 6.10 更 新 配置 状态 图 6.11 输入 新 的 配置 状态 
当前 配置 状态 将 即刻 被 更 新 。 
至 此 , 我 们 完整 地 实现 了 Messenger 应 用 程序 , 读者 可 对 其 进行 调整 并 尝试 添加 相关 
代码 。 本 章 剩余 部 分 还 将 涉及 两 个 话题 ， 即 应 用 程序 测试 和 执行 后 台 任 务 。 


6.4 Android 应 用 程序 测试 


应 用 程序 测试 是 指 测试 开发 完毕 的 程序 ， 并 对 其 质量 进行 检测 ， 诸 多 因素 均 会 对 软 
件 质量 产生 影响 ， 包 括 应 用 程序 可 用 性 、 功 能 、 可 靠 性 以 及 一 致 性 。Android 应 用 程序 测 
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试 包含 许多 优点 ， 包 含 但 不 仅 限于 以 下 内 容 : 

口 错误 检测 。 

Q 软件 的 可 靠 性 。 

Android 应 用 程序 集成 测试 涵盖 了 大 量 内 容 ， 因 而 也 超出 了 本 书 的 讨论 范围 , 但 读者 
应 留意 下 列 Android 测试 资源 : 

Q Espresso, 对 应 网 址 为 https://developer.android.com/training/testing/espresso/index.html。 
O ”Roboelectric， 对 应 网 址 为 http://robolectric.org。 

口 Mockito， 对 应 网 址 为 http://site.mockito.org。 

Q ”Calabash， 对 应 网 址 为 https://github.com/calabash/calabash-android。 


65 执行 后 台 操 作 


在 开发 Messenger 应 用 程序 时 , 我 们 曾 使 用 了 RxAndroid 并 执行 异步 操作 。 在 许多 场 
合 下 ， 当 使 用 RxAndroid 时 ,可 在 Android 应 用 程序 的 主线 程 上 查看 后 台 运 行 结果 。 某 些 
时 候 ， 读 者 可 能 不 希望 使 用 第 三 方 库 实 现 这 一 功能 ， 例 如 RxAndroid。 相 反 ， 读 者 更 愿意 
采用 Android 应 用 程序 框架 中 的 解决 方案 。 针 对 于 此 ，Android 提供 了 多 种 选择 方案 ， 
AsyncTask 便 是 其 中 之 一 。 


6.5.1 AsyncTask 


AsyncTask 类 可 查看 后 台 操作 的 性 能 ， 并 在 应 用 程序 UI 线程 中 显示 操作 结果 ， 且 无 
须 管 理 处 理 程序 和 线程 。AsyncTask 适用 于 运行 小 型 操作 任务 。 其 间 ，AsyncTask 的 计算 
部 分 运行 于 后 台 线 程 ， 对 应 结果 将 显示 于 UI 线程 中 。 关 于 AsyncTask 的 更 多 信息 ， 读 者 
可 访问 https://developer.android.com/reference/android/os/AsyncTask.html. 


6.5.2 IntentService 


当 在 后 台中 运行 调度 任务 时 ，IntentService 是 一 类 较 好 的 候选 方案 。Android 开发 参 
考 中 指出 ，IntentService 定义 为 服务 基 类 ， 用 于 即时 处 理 异 步 请 求 〈 表 示 为 Intent) 。 客 
户 端 通过 startService 〈Jntent) 调用 发 送 请 求 ， 服务 在 必要 时 启用 ， 并 通过 工作 线程 处 理 
每 个 Intent， 并 在 任务 结束 时 执行 终止 。 关 于 IntentService 的 更 多 内 容 ， 读 者 可 访问 
https://developer.android.com/reference/android/app/IntentService.html . 
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66 本 章 小 结 


本 章 结束 了 Messenger Android 应 用 程序 开发 之 旅 。 其 间 ， 我 们 学 习 了 用 于 创建 聊天 
用 户 界面 的 第 三 方 库 ChatKit。 除 此 之 外 ， 还 进一步 讨论 了 Android 应 用 程序 框架 提供 的 
各 种 工具 。 本 章 首先 介绍 了 Android 中 的 设置 活动 开发 过 程 ， 并 了 解 了 PreferenceScreen、 
PreferenceActivity、DialogPreference、Preference 和 PreferenceFragment。 最 后 ， 本 章 还 简 
要 介绍 了 Android 应 用 程序 测试 机 制 ， 以 及 执行 后 台 操 作 任务 。 

第 7 章 将 讨论 Android 应 用 程序 框架 中 的 各 种 存储 选择 方案 。 


第 7 章 在 数据 库 中 存储 信息 


在 第 6 章 中 ,我 们 介绍 了 一 些 较为 重要 的 话题 ,包括 第 三 方 库 的 使 用 、Android 应 用 
程序 测试 机 制 ， 以 及 如 何在 Android 平台 上 运行 后 台 任 务 。 本 章 主要 讨论 数据 的 存储 。 前 
述 内 容 曾 针对 不 同 实例 对 持久 化 应 用 程序 数据 进行 存储 ， 例 如 通过 SharedPreferences ij 
足 数据 存储 需求 , 但 该 方案 并 不 是 Android 应 用 程序 框架 中 的 唯一 数据 存储 方式 。 本 章 将 
深度 探讨 Android 中 的 数据 存储 方式 ， 且 主要 涉及 以 下 内 容 : 

ü ”内 部 存储 。 

ü ”外 部 存储 。 

口 网络 存储 。 

QO 内 容 提 供 商 。 

除 此 之 外 ， 我 们 还 将 针对 不 同 应 用 选取 最 佳 存储 方案 。 下 面 首先 讨论 内 部 存储 。 


Q i5. 


代码 中 省 略 号 所 表示 的 内 容 位 于 对 应 的 代码 文件 中 


7.1 与 内 部 存储 协同 工作 


Android 应 用 程序 框架 中 的 现 有 存储 媒介 可 使 开发 人 员 存储 设备 内 存 中 的 私人 数据 。 
这 里 ，“ 私 人 数据 ”是 指 其 他 应 用 程序 无 法 通过 内 部 存储 访问 App 存储 的 数据 。 除 此 之 
外 ， 当 应 用 程序 被 卸载 时 ， 此 类 文件 将 从 存储 中 移 除 。 


7.1.1 向 内 部 存储 中 写 入 文件 


当 在 内 部 存储 中 创建 私有 文件 时 ， 可 调用 openFileOutputO0 函 数 。openFileOutputO) 函 
数 接收 两 个 参数 。 其 中 ， 第 一 个 参数 表示 为 文件 名 (以 String 方式 表示 ) ; 第 二 个 参数 
为 操作 模式 。 需 要 注意 的 是 ，openFileOutput0 函 数 须 在 Context 实例 中 被 调用 ， 例 如 
Activity。 

openFileOutputO 函 数 返 回 一 个 FileOutputStream, 随后 用 于 通知 当前 文件 可 利用 write() 
方法 完成 操作 。 当 写 入 操作 结束 后 ，FileOutputStream 通过 调用 close0 方 法 被 关闭 。 下 列 
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代码 显示 了 这 一 处 理 过程 。 


private fun writeFile(fileName: String) { 
val content: String - "Hello world" 
val stream: FileOutputStream = openFileOutput (fileName, 
Context.MODE PRIVATE) 


stream.write (content.toByteArray () ) 
stream.close() 


} 


7.1.2 ”从 内 部 存储 中 读 取 私 有 文件 


当 读 取 私 有 文件 时 ， 可 通过 调用 openFileInputO 获 取 FileInputStream。 该 方法 包含 单 
一 参数 ， 即 所 读 取 的 文件 名 。 同 样 ，openFileInputO 须 在 Context 实例 中 被 调用 。 当 获得 
FileInputStream 之 后 ， 即 可 调用 read0 函 数 从 当前 文件 中 读 取 字 节 。 当 文件 读 取 完 毕 后 ， 
可 调用 close0 执 行 关闭 操作 。 

考察 下 列 代 码 : 

private fun readFile(fileName: String) ( 


val stream: FileInputStream - openFileInput (fileName) 
val data - ByteArray (1024) 


Stream.read (data) 
stream.close() 


) 


7.4.8. 基于 内 部 存储 的 示例 程序 


适宜 的 示例 程序 可 帮助 我 们 进一步 理解 相关 概念 ， 本 节 将 利用 内 部 存储 机 制 实 现 一 
个 文件 更 新 程序 。 文 件 的 更 新 操作 较为 简单 ， 即 收集 用 户 文本 数据 ( 源 自 输入 框 》， 并 
更 新 内 部 存储 中 的 文件 。 随 后 ， 用 户 可 通过 应 用 程序 中 的 视图 查看 文件 文本 内 容 。 下 面 
创建 一 个 新 的 Android 项 目 , 其 名 称 应 适当 反映 当前 应 用 程序 的 功能 .在 项 目 创建 完毕 后 ， 
在 src 项 目 包 中 分 别 创建 base 包 和 main 包 。 

相应 地 ，base 包 中 的 BaseView 接口 包含 下 列 代码 : 


package com.example.storageexamples.base 


interface BaseView { 
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fun bindViews () 


fun setupInstances() 


} 


如 果 读 者 阅读 了 前 述 章 节 ， 相 信 已 对 视图 界面 有 所 了 解 。 在 main 包 中 ， 可 定义 一 个 
MainView 并 扩展 BaseView， 如 下 所 示 : 


package com.example.storageexamples.main 
import com.example.storageexamples.base.BaseView 
interface MainView : BaseView { 


fun navigateToHome () 
fun navigateToContent () 


} 

文件 更 新 应 用 程序 包含 了 两 个 片段 形式 的 视图 ， 其 中 ， 第 一 个 视图 表示 为 主 视图 ， 
用 户 可 以 此 更 新 文件 内 容 ， 第 二 个 视图 则 表示 为 内 容 视 图 ， 用 户 可 据 此 读 取 更 新 文件 的 
内 容 。 

下 面 在 main 中 创建 空 活动 ， 并 将 其 命名 为 MainActivity， 同 时 确保 MainActivity 为 
启动 活动 。 当 MainActivity 创建 完毕 后 ， 应 保证 其 在 执行 前 扩展 了 MainView。 打 开 
activity_main.xml 并 添加 下 列 内 容 : 


<?xml version-"1.0" encoding="utf-8"?> 
«android.support.constraint.ConstraintLayout 


xmlns:android-"http://schemas.android.com/apk/res/android" 
xmlns:tools-"http://schemas.android.com/tools" 
android:layout width-"match parent" 
android:layout height-"match parent" 
tools:context="com.example.storageexamples.main.MainActivity"> 


<LinearLayout 
android:id="@+id/1l container" 
android:layout width="match parent" 
android:layout height-"match parent" 
android:orientation-"vertical"/» 
</android.support.constraint.ConstraintLayout> 
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上 述 代码 将 LinearLayout 视图 组 添加 至 布局 文件 的 根 视图 中 , 该 布局 可 视 作 应 用 程 
序 主 片段 和 内 容 片段 的 容器 。 下 列 代码 表示 为 主 片段 布局 (位 于 fragment home.xml X 
件 中 ) : 


<?xml version-"1.0" encoding-"utf-8"?» 
<LinearLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"match parent" 
android:paddingTop-"Gdimen/padding default" 
android:paddingBottom-"Gdimen/padding default" 
android:paddingStart="@dimen/padding default" 
android:paddingEnd="@dimen/padding default" 
android:gravity-"center horizontal" 
android:layout height="match parent"> 
<TextView 
android: id="@+id/tv header" 
android: layout_width="wrap_ content" 
android: layout_height="wrap content" 
android:text="@string/header title" 
android: textSize="45sp" 
android: textStyle="bold"/> 
<EditText 
android: id="@+id/et_input" 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android:layout marginTop="@dimen/margin top large" 
android:hint="@string/hint enter text"/> 
<Button 
android: id="@+id/btn submit" 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android:layout marginTop="@dimen/margin default" 
android: text="@string/submit"/> 
<Button 
android:id="@+id/btn view file" 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android:text="@string/view file" 
android: background="@android:color/transparent"/> 
</LinearLayout> 
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在 打开 设计 窗口 以 查看 布局 变化 之 前 ， 还 需要 添加 一 些 数 值 资 源 。 当 前 项 目的 
strings.xml 文件 应 涵盖 以 下 内 容 〈 除 app name 字符 串 资源 之 外 ) : 


«resources» 
«string name-"app name"»Storage Examples</string> 


<string name="hint enter text">Enter text here..</string> 
<string name="submit">Update file</string> 

<string name="view file">View file</string> 

<string name="header title">FILE UPDATER</string> 


</resources> 
除 此 之 外 ， 当 前 项 目 还 应 包含 dimens.xml 文件 ， 并 涵盖 以 下 内 容 : 


<?xml version-"1.0" encoding-"utf-8"?» 


«resources» 
<dimen name="padding default">16dp</dimen> 
<dimen name="margin default">16dp</dimen> 
<dimen name="margin top large">64dp</dimen> 
</resources> 


当 添加 了 上 述 资源 后 ， 即 可 看 到 如 图 7.1 RKI, fragment home.xml 中 的 布局 设计 
窗口 。 


Storage Examples 


FILE UPDATER 


UPDATE FILE 


VIEW FILE 


图 7.1 布局 设计 窗口 
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对 于 内 容 片段 布局 ， 向 布局 资源 目录 的 fragment contentxml 布局 文件 中 添加 下 列 代码 : 


<?xml version-"1.0" encoding-"utf-8"?» 
<LinearLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"match parent" 
android:padding="@dimen/padding default" 
android:layout height-"match parent"» 
<TextView 
android:id="@+id/tv content" 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android:textSize-"20sp" 
android:textStyle-"bold" 
android:layout marginTop="@dimen/margin default"/> 
</LinearLayout> 


该 布局 包含 了 单一 的 TextView， 并 向 应 用 程序 用 户 显 示 内 部 存储 文件 中 的 文本 。 如 
果 读 者 感 兴趣 的 话 ， 可 查看 当前 布局 设计 窗口 。 

此 时 ， 需 要 定义 相应 的 片段 类 ， 以 显示 刚刚 创建 的 片段 布局 。 对 此 ， 可 将 
HomeFragment 类 添加 至 MainActivity 中 ， 如 下 所 万 


class HomeFragment : Fragment(), BaseView, View.OnClickListener { 


private lateinit var layout: LinearLayout 
private lateinit var tvHeader: TextView 
private lateinit var etInput: EditText 
private lateinit var btnSubmit: Button 
private lateinit var btnViewFile: Button 


private var outputStream: FileOutputStream? - null 


override fun onCreateView(inflater: LayoutInflater, 
container: ViewGroup?, 
savedInstanceState: Bundle?): View { 


// inflate the fragment home.xml layout 

layout = inflater.inflate(R.layout.fragment home, 
container, false) as LinearLayout 

setupInstances() 

bindViews () 
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return layout 


} 


override fun bindViews() { 
tvHeader = layout.findViewById(R.id.tv header) 
etInput = layout.findViewById(R.id.et input) 
btnSubmit = layout.findViewById(R.id.btn submit) 
btnViewFile = layout.findViewById(R.id.btn view file) 


btnSubmit.setOnClickListener (this) 
btnViewFile.setOnClickListener (this) 
} 


下 列 方 法 用 于 实例 属性 的 实例 化 操作 。 

override fun setupInstances() { 

下 面向 一 个 名 为 content. file 的 文件 启用 FileOutputStream, 该 文件 表示 为 内 部 存储 的 
私有 文件 ， 因 而 只 可 被 当前 应 用 程序 所 访问 ， 如 下 所 示 : 


outputStream = activity?.openFileOutput ("content file", 
Context.MODE PRIVATE) 


} 
如 果 出 现 无 效 输 入 ， 下 列 函 数 将 被 调用 ， 并 向 用 户 显示 一 条 错误 消息 。 


private fun showInputError() { 
etInput.error = "File input cannot be empty." 
etInput.requestFocus() 

) 


下 面 通过 FileOutputStream 写 入 字符 串 内 容 。 


private fun writeFile(content: String) { 
outputStream?.write(content.toByteArray()) 
outputStream?.close() 


} 
下 列 函 数 用 于 清空 输入 框 中 的 输入 内 容 。 


private fun clearInput() { 
etInput.setText ("") 
} 


调用 下 列 函 数 将 向 用 户 显示 一 条 成 功 消息 。 
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private fun showSaveSuccess() { 
Toast.makeText(activity, "File updated successfully.", 


Toast.LENGTH LONG).show() 


} 


override fun onClick(view: View?) { 
val id = view?.id 
if d == R.id-btn submit} | 
if (TextUtils.isEmpty(etInput.text)) { 


如 果 用 户 提供 了 一 个 空 值 作为 文件 输入 内 容 ， 那 么 ， 函 数 将 显示 一 条 人 
下 所 示 : 


showInputError () 
) else ( 


下 面向 文件 中 写 入 内 容 ， 清 空 EditText 并 显示 文件 更 新 成 功 消 息 。 


着 误 消息 ， 如 


writeFile(etInput.text.toString()) 


clearInput () 
showSaveSuccess () 
) 
) else if (id -- R.id.btn view file) ( 
// retrieve a reference to MainActivity 
val mainActivity - activity as MainActivity 


下 列 代码 将 用 户 转 至 内 容 片段 ， 并 在 动作 栏 上 显示 主 按钮 ， 以 使 用 户 可 返回 至 上 一 
个 片段 。 


mainActivity.navigateToContent () 
mainActivity.showHomeNavigation() 


) 
} 
} 
读者 应 留意 HomeFragment 中 的 注释 内 容 ， 以 确保 理解 具体 的 操作 含义 。 在 将 
HomeFragment 添加 至 MainActivity 后 ， 还 需要 添加 一 个 片段 ， 并 向 用 户 显示 
fragment content.xml 布局 。 对 此 ， 可 将 ContentFragment 类 添加 至 MainActivity 中 ， 如 下 


所 示 : 


class ContentFragment : BaseView { 


Fragment (), 


private lateinit var layout: LinearLayout 
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private lateinit var tvContent: TextView 
private lateinit var inputStream: FileInputStream 


override fun onCreateView(inflater: LayoutInflater?, 
container: ViewGroup?, 
savedInstanceState: Bundle?): View ( 


layout - inflater?.inflate(R.layout.fragment content, 
container, false) as LinearLayout 


setupInstances() 
bindViews () 


return layout 


override fun onResume() { 
下 列 代码 在 恢复 片段 时 更 新 TextView 中 呈现 的 内 容 。 


updateContent () 
super .onResume () 


} 


private fun updateContent() { 
tvContent.text = readFile() 


override fun bindViews() { 
tvContent = layout.findViewById(R.id.tv content) 


override fun setupInstances() { 
inputStream = activity.openFileInput ("content file") 


} 
下 列 代码 将 读 取 内 部 存储 中 的 文件 内 容 ， 并 以 字符 串 显示 返回 对 应 内 容 ， 如 下 所 示 : 


private fun readFile(): String { 
var c: Int 
var content = "" 


c = inputStream.read() 
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while (c != -1) { 
content += Character.toString(c.toChar()) 
c = inputStream.read() 
inputStream.close() 


return content 


} 


当 恢 复 ContentFragment I], tvContent 实例 〈 向 用 户 显示 文件 内 容 的 TextView) 将 
被 更 新 。TextView 的 更 新 过 程 可 描述 为 : 将 TextView 的 内 容 设 置 为 文件 的 读 取 内 容 〈 利 
用 readFileQ 2) 。 最 后 一 项 任务 是 完成 MainActivity。 完 整 的 MainActivity 类 定义 如 下 
所 示 : 


package com.example.storageexamples.main 


import android.aupport.v4.app.Fragment 

import android.content.Context 

import android.support.v7.app.AppCompatActivity 
import android.os.Bundle 

import android.text.TextUtils 

import android.view.LayoutInflater 

import android.view.MenuItem 

import android.view.View 

import android.view.ViewGroup 

import android.widget.* 

import com.example.storageexamples.R 

import com.example.storageexamples.base.BaseView 
import java.io.FileInputStream 

import java.io.FileOutputStream 


class MainActivity : AppCompatActivity(), MainView ( 


private lateinit var llContainer: LinearLayout 


下 面 设 置 片段 实例 ， 如 下 所 示 : 


private lateinit var homeFragment: HomeFragment 


private lateinit var contentFragment: ContentFragment 


override fun onCreate(savedInstanceState: Bundle?) { 
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super.onCreate (savedInstanceState) 
setContentView(R.layout.activity main) 
setupInstances () 

bindViews () 

navigateToHome () 


override fun bindViews() { 
llContainer = findViewById(R.id.ll container) 


override fun setupInstances() { 
homeFragment = HomeFragment () 
contentFragment = ContentFragment () 


private fun hideHomeNavigation() { 
supportActionBar?.setDisplayHomeAsUpEnabled (false) 
} 


private fun showHomeNavigation() { 
supportActionBar?.setDisplayHomeAsUpEnabled (true) 


override fun navigateToHome() ( 
val transaction - supportFragmentManager.beginTransaction() 
transaction.replace(R.id.ll container, homeFragment) 
transaction.commit () 


supportActionBar?.title = "Home" 

override fun navigateToContent() { 
val transaction = supportFragmentManager.beginTransaction() 
transaction.replace(R.id.ll container, contentFragment) 
transaction.commit () 
supportActionBar?.title = "File content" 


override fun onOptionsItemSelected(item: Menultem?): Boolean { 
val id = item?.itemId 
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if (id == android.R.id.home) ( 
navigateToHome () 
hideHomeNavigation () 


} 


return super.onOptionsItemSelected (item) 


class HomeFragment : Fragment(), BaseView, View.OnClickListener { 


private lateinit var layout: LinearLayout 
private lateinit var tvHeader: TextView 
private lateinit var etInput: EditText 
private lateinit var btnSubmit: Button 
private lateinit var btnViewFile: Button 


private lateinit var outputStream: FileOutputStream 


override fun onCreateView(inflater: LayoutInflater?, 
container: ViewGroup?, 
savedInstanceState: Bundle?): View ( 


下 列 代码 用 于 创建 fagment_home.xml 布局 : 


layout = inflater .inflate(R.layout.fragment home, 
container, false) as LinearLayout 

setupInstances () 

bindViews () 

return layout 


override fun bindViews() { 
tvHeader = layout.findViewById(R.id.tv header) 
etInput = layout.findViewById(R.id.et input) 
btnSubmit = layout.findViewById(R.id.btn submit) 
btnViewFile = layout.findViewById(R.id.btn view file) 


btnSubmit.setOnClickListener (this) 


btnViewFile.setOnClickListener (this) 


//Method for the instantiation of instance properties 


override fun setupInstances() { 
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下 面 针 对 content file 打开 FileOutputstream， 该 文件 为 内 部 存储 中 的 私有 文件 ， 因 而 
仅 可 被 当前 应 用 程序 所 访问 ， 如 下 所 示 : 


outputStream = activity.openFileOutput ("content file", 
Context.MODE PRIVATE) 


//Called to display an error to the user if an invalid input is given 
private fun showInputError() ( 
etInput.error - "File input cannot be empty." 
etInput.requestFocus() 


// Writes string content to a file via a [FileOutputStream] 
private fun writeFile(content: String) ( 

outputStream.write (content.toByteArray()) 
) 


//Called to clear the input in the input field 


private fun clearInput() ( 
etInput.setText ("") 
} 


//Shows a success message to the user when invoked. 
private fun showSaveSuccess() { 
Toast.makeText (activity, "File updated successfully.", 
Toast.LENGTH LONG) .show() 


override fun onClick(view: View?) { 
val id = view?.id 


if (id == R.id.btn_submit) { 


如 果 用 户 提交 了 空 值 作 为 文件 输入 内 容 ， 下 列 代码 片段 将 显示 一 条 错误 消息 。 


if (TextUtils.isEmpty(etInput.text)) { 
showInputError () 

) else ( 
//Write content to the file, clear the input 
//EditText and show a file update success message 
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writeFile(etInput.text.toString()) 
clearInput () 
showSaveSuccess () 
} 
} else if (id == R.id.btn view file) { 
// retrieve a reference to MainActivity 
val mainActivity = activity as MainActivity 


下 面 将 用 户 转 至 内 容 片段 ， 并 在 动作 栏 上 显示 主 按 钮 ， 以 使 用 户 能 够 返回 至 上 一 个 
片段 ， 如 下 所 示 : 


mainActivity.navigateToContent () 
mainActivity.showHomeNavigation() 


} 


class ContentFragment : Fragment(), BaseView { 


private lateinit var layout: LinearLayout 
private lateinit var tvContent: TextView 


private lateinit var inputStream: FileInputStream 


override fun onCreateView(inflater: LayoutInflater?, 
container: ViewGroup?, 
savedInstanceState: Bundle?): View { 


layout = inflater?.inflate(R.layout.fragment content, 
container, false) as LinearLayout 

setupInstances () 

bindViews () 


return layout 


} 
当 恢复 片段 时 ， 下 列 代码 将 更 新 TextView 中 的 内 容 。 


override fun onResume() ( 
updateContent () 
super.onResume () 


} 
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private fun updateContent() { 
tvContent.text = readFile() 


} 


override fun bindViews() { 


tvContent = layout.fi 
} 


ndViewById(R.id.tv content) 


override fun setupInstances() { 
inputStream = activity.openFileInput ("content_file") 


} 


下 列 代码 读 取 内 部 存储 中 的 文件 内 容 ， 并 以 字符 串 形 式 返 回 该 内 容 。 


private fun readFile(): String ( 


viste (25° MME 
var content - "" 


c = inputStream.re 


while (c != -1) ( 


ad() 


content += Character.toString(c.toChar ()) 
c = inputStream.read() 


) 
inputStream.close( 


return content 
) 
} 
} 


MainActivity 已 经 全 部 完成 ， 


) 


下 面 准 备 运 行 应 用 程序 。 


在 所 选取 的 设备 上 构建 并 运行 当前 项 目 。 但 启动 应 用 程序 后 ，MainActivity 的 主 片段 


将 显示 在 设备 上 ， 读 者 可 在 Edit 
在 向 EditText 中 输入 相关 内 


Text 输入 框 中 输入 任何 内 容 ， 如 图 7.2 所 示 。 
容 后 ， 单 击 UPDATE FILE 按钮 。 相 应 地 ， 内 部 存储 文件 


通过 所 提供 的 内 容 予 以 更 新 ， 随 后 将 显示 一 条 信息 。 在 文件 更 新 完毕 后 ， 可 单 击 VIEW 


FILE 按钮 ， 如 图 7.3 所 示 。 
内 容 片 段 显 示 于 TextView 4 


P. 取 值 包含 了 更 新 后 的 文件 内 容 。 尽管 该 程序 较为 简单 ， 


但 却 展示 了 Android 应 用 程序 与 


内 部 存储 之 间 的 工作 方式 。 
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€  Filecontent 


FI LE UPDATER Mary had a little lamb 


Little lamb, little lamb 
Mary had a little lamb 
Its fleece was white as snow 


Mary had a little lamb 
Little lamb, little lamb 
Mary had a little lamb 
Its fleece was white as snow| 


UPDATE FILE 


VIEW FILE 


图 7.2 在 EditText 输入 框 中 输入 内 容 图 7.3 文件 更 新 完毕 
7.1.4 保存 缓存 文件 

如 果 用 户 并 不 希望 永久 存储 数据 ， 而 是 在 存储 中 缓存 数据 ， 则 可 使 用 cacheDir 打开 
内 部 存储 中 的 目录 ， 其 中 临时 保存 了 缓存 文件 。 


cacheDir 返回 一 个 File。 因 此 ， 可 使 用 File 类 提供 的 全 部 方法 ， 例 如 outputStream() 
方法 ， 该 方法 将 返回 一 个 FileOutputStream。 


72 与 外 部 存储 协同 工作 


外 部 存储 用 于 创建 和 访问 非 私 有 、 共 享 的 公有 文件 。Android 设备 均 支 持 共享 外 部 存 
储 机 制 。 对 此 ， 首 先 需要 获得 外 部 存储 许可 。 


7.2.1 获得 外 部 存储 许可 


应 用 程序 在 使 用 外 部 存储 API 之 前 ， 须 获取 READ EXTERNAL STORAGE 和 
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WRITE EXTERNAL STORAGE 许可 。 当 仅 使 用 外 部 存储 的 读 取 功能 时 ， 
READ EXTERNAL STORAGE 许可 不 可 或 缺 ; 相应 地 , WRITE EXTERNAL STORAGE 
许可 则 表示 外 部 存储 的 写 入 操作 。 
上 述 两 项 许可 可 方便 地 添加 至 清单 文件 中 ， 如 下 所 示 : 
<uses-permission android:name-"android.permission.WRITE EXTERNAL STORAGE"/> 
<uses-permission android:name="android.permission.READ EXTERNAL STORAGE" /> 
需要 注意 的 是 , WRITE EXTERNAL STORAGE 隐 式 地 包含 了 READ EXTERNAL - 
STORAGE. 因此, 若 需 要 使 用 到 两 项 许可 ， 那 么 , 请 求 WRITE EXTERNAL STORAGE 
即 可 ， 如 下 所 示 : 


<uses-permission android:name="android.permission.WRITE EXTERNAL STORAGE"/> 


7.2.2 ”媒介 的 有 效 性 


某 些 时 候 ， 由 于 各 种 原因 ， 存 储 设备 往往 会 意外 丢失 一 一 外 部 存储 媒介 无 法 被 正常 
访问 。 相 应 地 ， 在 使 用 外 部 存储 媒介 之 前 ， 需 要 对 其 进行 检测 。 
getExternalStorageState() 方 法 可 用 于 检测 媒介 的 有 效 性 ， 下 列 代码 片段 将 检测 外 部 存 
储 是 否 可 写 入 应 用 程序 中 。 
private fun isExternalStorageWritable(): Boolean { 
val state = Environment.getExternalStorageState() 


return Environment.MEDIA MOUNTED -- state 
} 
首先 应 检索 外 部 存储 的 当前 状态 ， 并 于 随后 检测 其 是 否 处 于 MEDIA MOUNTED 状 
。 若 是 ， 那 么 ， 应 用 程序 可 向 其 写 入 。 对 此 ，isExternalStorageWritable0 将 返回 true. 
外 部 存储 的 读 取 检 测 同样 十 分 简单 ， 如 下 所 示 : 
private fun isExternalStorageReadable(): Boolean { 
val state = Environment.getExternalStorageState () 


er 


return Environment.MEDIA MOUNTED == state || 
Environment.MEDIA MOUNTED READ ONLY == state 
y 
若 处 于 MEDIA MOUNTED 或 MEDIA MOUNTED READ ONLY 状态 ， 应 用 程序 
则 可 从 外 部 存储 中 读 取 数据 。 
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7.2.3 ”存储 共享 文件 


供用 户 或 其 他 应 用 程序 访问 的 文件 应 存储 于 共享 公共 目录 中 , 例如 Pictures/ 和 Music/ 
目录 。 

当 检 索 表 示 为 公共 目录 的 File 时 ,应 用 程序 可 调用 getExternalStoragePulicDirectory() 
方法 。 其 中 ， 检 索 的 目录 类 型 则 作为 唯一 参数 传递 至 该 方法 中 。 

下 列 方法 针对 存储 的 音乐 素材 创建 了 一 个 目录 。 

private fun getMusicStorageDir(collectionName: String): File ( 


val file = File(Environment.getExternalStoragePublicDirectory( 
Environment.DIRECTORY MUSIC), collectionName) 


if (!file.mkdir()) ( 
Log.d("DIR CREATION STATUS", "Directory creation failed.") 
) 


return file 


} 
在 生成 公共 目录 过 程 中 若 出 现 错误 ， 相 关 消 息 将 输出 至 控制 台 


7.2.44 利用 外 部 存储 缓存 文件 


某 些 时 候 ， 可 能 会 出 现 需要 用 外 部 存储 缓存 文件 的 场景 。 对 此 ， 可 以 打开 一 个 表示 
外 部 存储 目录 的 文件 ， 其 中 应 用 程序 应 该 使 用 externalCacheDir 保存 缓存 的 文件 。 


73 网 络 存 储 


网 络 存储 是 指 远程 服务 器 上 的 数据 存储 。 与 之 前 讨论 的 其 他 存储 方式 不 同 ， 此 类 存 
储 方式 使 用 了 网 络 连接 存储 、 检 索 远 程 服务 器 上 的 数据 。 当 构建 第 6 章 中 的 Messenger 
Android 应 用 程序 时 ， 即 可 采用 这 一 类 存储 媒介 。 其 中 ，Messenger 应 用 程序 依赖 于 远程 
服务 器 存储 、 检 索 信息 。 当 远程 服务 器 用 于 客户 端 应 用 程序 的 数据 源 时 ， 常 会 使 用 到 客 
户 端 -服务 器 架构 。 客 户 端 通过 HTTP 向 服务 器 发 送 数 据 请 求 (一 般 采 用 GET 请 求 ) ; 作 
为 响应 ， 服 务 器 将 发 送 所 需 数 据 ， 进 而 完成 了 HTTP 事务 处 理 周 期 。 

SQLite 是 一 种 较为 流行 的 关系 型 数据 库 管理 系统 (RDBMS) ， 与 其 他 一 些 RDBMS 
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不 同 ，SQLite 并 未 采用 客户 机 -服务 器 数据 库 引擎 ， 而 是 直接 嵌入 应 用 程序 中 。 


Android 完全 支持 SQLite， 并 可 通过 类 这 一 Android 项 目 形式 访问 SQLite 数据 库 。 
需要 注意 的 是 ， 在 Android 中 ， 仅 可 通过 构建 数据 库 的 应 用 程序 对 SQLite 进行 访问 。 


当 在 Android 中 与 SQLite 协同 工作 时 ， 建 议 使 用 Room 持久 库 。 在 Android 4 


Jil Room 的 第 一 个 步骤 在 项 目的 build.gradle 脚本 中 包含 下 列 依赖 关系 : 


implementation "android.arch.persistence.room:runtime:1.0.0-alpha9 
implementation "android.arch.persistence.room:rxjava2:1.0.0-alpha9 
implementation "io.reactivex.rxjava2:rxandroid:2.0.1" 

kapt "android.arch.persistence.room:compiler:1.0.0-alpha9-1" 


借助 于 Room， 实体 访问 变 得 更 加 简单 。 这 里 ， 所 有 实体 须 添 加 @Entity 注解 。 
代码 显示 了 简单 的 User 实体 。 

package com.example.roomexample.data 

import android.arch.persistence.room.ColumnInfo 


import android.arch.persistence.room.Entity 
import android.arch.persistence.room.PrimaryKey 


GEntity 

data class User( 
GColumnInfo(name = "first name") 
var firstName: String - "", 


@ColumnInfo (name = "surname") 

var surname: String - "", 
@ColumnInfo (name = "phone number") 
var phoneNumber: String - "", 
@PrimaryKey(autoGenerate = true) 
var id: Long = 0 


) 


p. Ab 


Bis 
E 


TAI 


Room 针对 所 定义 的 User 实体 生成 所 需 的 SQLite 表 ， 该 表 中 包含 了 名 称 、user 以 及 
4 个 属性 ， 即 id. first name, surname 和 phone_number。 其 中 ，id 属性 是 创建 的 用 户 表 


的 主 属性 ， 我 们 通过 @PrimaryKey 注解 对 此 加 以 指定 。 用 户 表 每 条 记录 中 的 主键 可 通过 


Room 生成 ， 即 在 @PrimaryKey 注解 中 设置 autoGenerate = true。 注 解 @ColumnInfo 则 用 


于 指定 与 表 中 某 个 列 相关 的 附加 信息 。 例 如 ， 考 察 下 列 代码 片段 : 


@ColumnInfo (name = "first name") 
var firstName: String = "" 
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其 中 ，User 中 定义 了 一 个 firstName 属性 。@ColumnInfo(name -"first name") 将 用 户 
表 中 的 列 名 (针对 firstName 属性 ) 设置 为 first name。 

当 在 数据 库 中 读 取 、 写 入 记录 时 ， 需 要 使 用 到 数据 访问 对 象 (DAO) . DAO 利用 标 
注 方法 执行 数据 库 操 作 。 下 列 代码 显示 了 User 实体 中 的 DAO。 


package com.example.roomexample.data 


import android.arch.persistence.room.Dao 

import android.arch.persistence.room.Insert 

import android.arch.persistence.room.OnConflictStrategy 
import android.arch.persistence.room.Query 

import io.reactivex.Flowable 


GDao 
interface UserDao { 


@Query ("SELECT * FROM user") 
fun all(): Flowable<List<User>> 


@Query("SELECT * FROM user WHERE id = :id") 
fun findById(id: Long): Flowable<User> 


@Insert (onConflict = OnConflictStrategy.REPLACE) 
fun insert(user: User) 

) 

@Query 注解 将 DAO 中 的 方法 标识 为 查询 方法 。 其 中 ， 方 法 被 调用 时 执行 的 查询 操 
作 将 作为 数值 传递 至 注解 中 。 自然 情况 下 , 传递 至 @Query 的 查询 表示 为 SQL 查询 。SQL 
查询 涉及 大 量 的 内 容 ， 读 者 应 了 解 其 编写 方式 。 

@Insert 注解 用 于 向 表 中 插入 数据 。 相 应 地 ， 其 他 较为 重要 的 注解 还 包括 @Update 和 
@Delete， 分 别 用 于 更 新 、 删 除数 据 库 表 中 的 数据 。 

最 后 ， 在 创建 了 实体 和 DAO 后 ， 还 需要 定义 应 用 程序 的 数据 库 。 对 此 ， 可 定义 
RoomDatabase 的 子 类 ， 并 利用 @Database 对 其 进行 注解 。 最 小 限度 下 ， 该 注解 应 包括 实 
体 类 引用 集合 以 及 数据 库 版 本 号 。 下 列 代码 显示 了 简单 的 AppDatabase 抽象 类 定义 。 

GDatabase(entities = [User::class], version = 1) 


public abstract class AppDatabase : RoomDatabase() { 
abstract fun userDao(): UserDao 


}Now that we have our DAO and entity created, we must create an AppDatabase 
class. Add 
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在 定义 了 应 用 程序 数据 库 类 之 后 ， 通 过 调用 databaseBuilderO 可 得 到 数据 库 实 例 ， 如 
下 所 示 : 


val db = Room.databaseBuilder (<context>, AppDatabase::class.java, 
"app-database").build() 


一 旦 获得 RoomDatabase 实例 , 即 可 以 此 检索 数据 访问 对 象 , 进而 读 取 、 写 入 、 更 新 、 
查询 以 及 删除 数据 库 中 的 数据 。 

下 面 构建 一 个 简单 的 应 用 程序 ， 并 展示 如 何 借助 于 Android 中 的 Room 使 用 SQLite。 
在 该 应 用 程序 中 ， 用 户 可 手动 输入 与 人 员 相关 的 信息 ， 并 于 随后 查看 用 户 输入 信息 。 

利用 空 MainActivity 构建 新 的 Android 项 目 , 并 将 其 作为 启动 活动 ; 随后 将 下 列 依 赖 
关系 添加 至 应 用 程序 的 build.gradle 脚本 中 。 


implementation 'com.android.support:design:26.1.0' 
implementation "android.arch.persistence.room:runtime:1.0.0" 
implementation "android.arch.persistence.room:rxjava2:1.0.0" 
implementation "io.reactivex.rxjava2:rxandroid:2.0.1" 

kapt "android.arch.persistence.room:compiler:1.0.0" 


此 外 ， 还 需要 将 kotlin-kapt 独立 插件 添加 至 build.gradle 脚本 中 ， 如 下 所 示 : 
apply plugin: 'kotlin-kapt' 


在 加 入 了 上 述 项 目 依 赖 关系 后 ， 在 项 目的 source 包 中 创建 data fl ui 4. E ui fA, 
添加 MainView， 如 下 所 示 : 


package com.example.roomexample.ui 


interface MainView { 


fun bindViews () 
fun setupInstances () 


} 

在 向 世 包 中 加 入 了 MainView 后 ， 可 将 MainActivity 重 置 到 vi 包 中 。 下 面 处 理应 用 
程序 化 的 数据 库 问题 。 由 于 应 用 程序 将 存储 用 户 信息 ,因此 需要 定义 User 实体 。 相 应 地 ， 
可 向 data 包 中 添加 下 列 User 实体 。 


package com.example.roomexample.data 


import android.arch.persistence.room.ColumnInfo 
import android.arch.persistence.room.Entity 
import android.arch.persistence.room.PrimaryKey 
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Il 


GEntity 

data class User( 
@ColumnInfo (name = "first name") 
var firstName: String - "", 
GColumnInfo(name = "surname") 
var surname: String - "", 
@ColumnInfo (name = "phone number") 


Var phoneNumber: String - "", 
@PrimaryKey (autoGenerate = true) 
var id: Long = 0 


) 
下 列 代码 在 data 包 中 创建 UserDao. 


package com.example.roomexample.data 


import android.arch.persistence.room.Dao 

import android.arch.persistence.room.Insert 

import android.arch.persistence.room.OnConflictStrategy 
import android.arch.persistence.room.Query 

import io.reactivex.Flowable 


GDao 
interface UserDao { 


@Query ("SELECT * FROM user") 
fun all(): Flowable<List<User>> 


@Query ("SELECT * FROM user WHERE id = :id") 
fun findById(id: Long): Flowable<User> 


@Insert (onConflict = OnConflictStrategy.REPLACE) 
fun insert(user: User) 


) 


UserDao 接口 定义 了 3 个 方法 ,分 别 是 al0、findById0 和 insert0。 其 中 ，all0 方 法 返 
包含 所 有 用 户 列表 的 Flowable; findById0 方 法 搜索 与 传递 至 该 方法 中 id 相 匹配 的 User。 


若 存在 ， 该 方法 则 在 Flowable 中 返回 User。insert0 方 法 则 用 于 将 用 户 作 为 一 条 记录 插入 
User 表 中 。 


在 创建 了 DAO 和 实体 后 ， 还 需要 定义 AppDatabase 类 。 对 此 ， 可 将 下 列 代 码 添加 至 


data 包 中 。 
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package com.example.roomexample.data 


import android.arch.persistence.room.Database 
import android.arch.persistence.room.Room 

import android.arch.persistence.room.RoomDatabase 
import android.content.Context 


@Database(entities = arrayOf(User::class), version = 1, exportSchema = 
false) 
internal abstract class AppDatabase : RoomDatabase() { 


abstract fun userDao(): UserDao 


companion object Factory ( 
private var appDatabase: AppDatabase? - null 


fun create(ctx: Context): AppDatabase { 
if (appDatabase -- null) ( 
appDatabase = Room.databaseBuilder (ctx.applicationContext, 
AppDatabase::class.java, 
"app-database").build() 


return appDatabase as AppDatabase 


) 


) 


上 述 代 码 创 建 了 包含 单一 create0 函 数 的 Factory 伴生 对 象 ， 其 唯一 任务 是 生成 
AppDatabase 实例 〈 若 不 存在 ) ， 并 返回 该 实例 以 供 使 用 。 

最 后 一 项 与 数据 相关 的 任务 是 构建 AppDatabase。 当 前 ， 需 要 针对 应 用 程序 视图 生成 
相应 的 布局 。 对 此 ， 可 在 MainActivity 中 使 用 两 个 片段 。 第 一 个 片段 针对 新 创建 用 户 收 
集 输 入 信息 ; 第 二 个 片段 则 在 RecyclerView 中 显示 全 部 用 户 的 信息 。 这 里 ， 可 修改 
activity_main.xml 布局 并 包含 下 列 代码 : 

<?xml version-"1.0" encoding-"utf-8"?» 


«android.support.constraint.ConstraintLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 


xmlns:tools-"http://schemas.android.com/tools" 
android:layout width-"match parent" 
android:layout height-"match parent" 
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tools:context-"com.example.roomexample.ui.MainActivity"» 


<LinearLayout 
android: id="@+id/1l_ container" 
android: layout_width="match_ parent" 
android:layout height="match parent" 
android:orientation-"vertical"/» 
</android.support.constraint.ConstraintLayout> 


activity main.xml 中 的 LinearLayout 包含 了 MainActivity 中 的 片段 。 利 用 下 列 代码 ， 
可 将 fragment create user.xml 文件 加 入 resource 布局 目录 中 。 


<?xml version-"1.0" encoding-"utf-8"?» 
<LinearLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"match parent" 
android:layout height-"match parent" 
android:gravity-"center horizontal" 
android: padding="@dimen/padding default"> 
<TextView 
android: layout_width="wrap_ content" 
android:layout height-"wrap content" 
android:textSize-"32sp" 
android:text-"G8string/create user"/> 
<EditText 
android:id="@+tid/et first name" 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android: layout_marginTop="@dimen/margin_ default" 
android:hint="@string/first name" 
android: inputType="text"/> 
<EditText 
android: id="@+id/et_surname" 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android:layout marginTop="@dimen/margin default" 
android:hint-"Gstring/surname" 
android:inputType-"text"/» 
<EditText 
android: id="@+id/et_phone number" 
android:layout width-"match parent" 
android:layout height-"wrap content" 
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android:layout marginTop="@dimen/margin default" 
android:hint="@string/phone number" 
android:inputType-"phone"/» 
«Button 
android: id="@+id/btn_submit" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:layout marginTop="@dimen/margin default" 
android: text="@string/submit"/> 
<Button 
android: id="@+id/btn_view_users" 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android:layout marginTop="@dimen/margin default" 
android:text-"G8string/view users"/> 
</LinearLayout> 


随后 将 下 列 代码 添加 至 fragment list users.xml 布局 资源 中 。 


<?xml version-"1.0" encoding-"utf-8"?» 
<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"match parent" 
android:layout height="match parent"> 
<android. support.v7.widget .RecyclerView 
android: id="@t+id/rv_users" 
android:layout width-"match parent" 
android:layout height-"match parent"/» 
</LinearLayout> 


fragment list users.xml 文件 包含 了 一 个 RecyclerView， 进 而 显示 保存 至 数据 库 中 的 
每 个 用 户 的 信息 。 对 此 ， 须 针对 RecyclerView 创建 一 个 视图 容器 布局 资源 项 ， 对 应 布局 
文件 称 作 vh_user.xml， 并 将 添加 下 列 代码 : 


<?xml version-"1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"match parent" 
android:padding-"G8dimen/padding default" 
android:layout height-"wrap content"» 
<TextView 
android: id="@+id/tv_first_name" 


android:layout width-"wrap content" 
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android:layout height-"wrap content"/» 
<TextView 
android:id="@+id/tv surname" 
android: layout_width="wrap_ content" 
android: layout_height="wrap content" 
android:layout marginTop="@dimen/margin default"/> 
<TextView 
android: id="@+id/tv phone number" 
android:layout width="wrap content" 
android:layout height-"wrap content" 
android: layout_marginTop="@dimen/margin_default"/> 
<View 
android:layout width="match parent" 
android:layout height-"1dp" 
android:layout marginTop="@dimen/margin default" 
android:background-"$e8e8e8"/» 
</LinearLayout> 


相信 读者 已 经 猜测 到 ， 这 里 还 需要 向 
打开 应 用 程序 的 strings.xml 布局 文件 ， 并 向 其 中 加 入 下 列 字符 串 资源 : 


当前 项 目 中 添加 一 些 字符 串 和 尺寸 资源 。 相 应 


<resources> 
<string name="first name">First name</string> 
<string name="surname">Surname</string> 
<string name="phone number">Phone number</string> 
<string name="submit">Submit</string> 
<string name="create user">Create User</string> 
<string name="view users">View users</string> 
</resources> 


随后 在 项 目 中 生成 下 列 尺 寸 资源 : 


<?xml version-"1.0" encoding="utf-8"?> 


«resources» 


Xdimen name-"padding default">16dp</dimen> 
<dimen name-"margin default">16dp</dimen> 
</resources> 


下 


i 开始 着 手 处 理 MainActivity。 如 前 所 述 ， 我 们 将 在 MainActivity 中 使 用 到 两 个 独 


立 的 片段 。 其 中 ， 第 一 个 片段 可 将 个 人 数据 保存 至 SQL 数据 库 中 ; 第 二 个 片段 则 允许 用 


户 查 看 已 保存 至 数据 库 中 的 人 员 信 息 。 
首先 定义 CreateUserFragment， 并 将 下 列 片段 类 添加 至 MainActivity 4 


P 《位 于 文件 
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MainActivity.kt 中 ) 。 


class CreateUserFragment : Fragment(), MainView, View.OnClickListener ( 


private lateinit var btnSubmit: Button 
private lateinit var etSurname: EditText 
private lateinit var btnViewUsers: Button 
private lateinit var layout: LinearLayout 
private lateinit var etFirstName: EditText 
private lateinit var etPhoneNumber: EditText 


private lateinit var userDao: UserDao 
private lateinit var appDatabase: AppDatabase 


override fun onCreateView(inflater: LayoutInflater, 
container: ViewGroup?, savedInstanceState: Bundle?): View ( 
layout = inflater.inflate(R.layout.fragment create user, 
container, false) as LinearLayout 
bindViews () 
setupInstances () 
return layout 


override fun bindViews() { 
btnSubmit = layout.findViewById(R.id.btn submit) 
btnViewUsers = layout.findViewById(R.id.btn view users) 
etSurname = layout.findViewById(R.id.et surname) 
etFirstName - layout.findViewById(R.id.et first name) 
etPhoneNumber - layout.findViewById(R.id.et phone number) 


btnSubmit.setOnClickListener (this) 
btnViewUsers.setOnClickListener (this) 


override fun setupInstances() ( 
appDatabase = AppDatabase.create (activity) 
// getting an instance of AppDatabase 
userDao = appDatabase.userDao() // getting an instance of UserDao 


) 
下 列 方法 验证 以 用 户 表单 形式 提交 的 输入 内 容 : 


private fun inputsValid(): Boolean ( 
var inputValid - true 
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val firstName = etFirstName.text 
val surname = etSurname.text 
val phoneNumber = etPhoneNumber.text 


if (TextUtils.isEmpty(firstName)) { 
etFirstName.error = "First name cannot be empty" 
etFirstName.requestFocus () 
inputValid = false 


} else if (TextUtils.isEmpty(surname)) { 
etSurname.error = "Surname cannot be empty" 
etSurname. requestFocus () 
inputValid = false 


else if (TextUtils.isEmpty(phoneNumber)) { 
etPhoneNumber.error = "Phone number cannot be empty" 
etPhoneNumber. requestFocus () 

inputValid = false 


) else if ('!android.util.Patterns. PHONE 
-Matcher (phoneNumber) .matches()) { 
etPhoneNumber.error = "Valid phone number required" 
etPhoneNumber.requestFocus () 
inputValid = false 


return inputValid 


} 
下 列 函 数 用 于 显示 相关 消息 ， 以 表明 用 户 已 成 功 创建 。 


private fun showCreationSuccess() ( 
Toast.makeText (activity, "User successfully created.", 
Toast.LENGTH LONG).show() 


override fun onClick(view: View?) ( 
val id = view?.id 


if (id -- R.id.btn submit) ( 
if (inputsValid()) { 
val user = User ( 
etFirstName.text.toString(), 
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etSurname.text.toString(), 
etPhoneNumber.text.toString()) 


Observable.just (userDao) 
-subscribeOn (Schedulers.io()) 
.subscribe( ( dao -> 
dao.insert(user) // using UserDao to save user to database. 
activity?.runOnUiThread ( showCreationSuccess() } 
), Throwable::printStackTrace) 
) 


} else if (id — R.id.btn view users) { 
val mainActivity = activity as MainActivity 


mainActivity.navigateToList () 
mainActivity.showHomeButton () 
} 
} 
} 


前 述 内 容 已 经 讨论 过 片段 多 次 ， 因 而 此 处 重点 在 于 与 AppDatabase 协同 工作 的 片段 
部 分 。 在 setupInstances0 中 ， 将 设置 指向 AppDatabase 和 UserDao 的 引用 。 通 过 调用 
AppDatabase 的 Factory 伴生 对 象 的 create0 函 数 ， 可 得 到 AppDatabase 实例 。UserDao 则 
可 通过 调用 appDatabase.userDao0 得 到 。 

下 面 考察 片段 类 中 的 onClick0 方 法 。 当 单 击 提交 按钮 时 ， 所 提交 的 用 户 信 息 将 执行 
有 效 性 检测 。 如 果 输 入 内 容 无 效 ， 则 会 显示 相应 的 错误 信息 ; 否则 ， 将 创建 包含 所 提交 
的 用 户 信息 的 新 User 对 象 ， 并 保存 至 数据 库 中 。 下 列 代码 实现 了 上 述 功能 。 

if (inputsValid()) { 

val user - User( 
etFirstName.text.toString(), 


etSurname.text.toString(), 
etPhoneNumber.text.toString()) 


Observable.just (userDao) 
-subscribeOn (Schedulers.io()) 
-subscribe( { dao -> 
dao.insert(user) // using UserDao to save user to database. 
activity?.runOnUiThread ( showCreationSuccess() } 
}, Throwable::printStackTrace) 
) 


同样 ，ListUsersFragment 的 构建 过 程 也 较为 简单 。 对 此 ， 将 下 列 ListUsersFragment 
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添加 至 MainActivity 中 ， 如 下 所 示 : 
class ListUsersFragment : Fragment(), MainView ( 


private lateinit var layout: LinearLayout 
private lateinit var rvUsers: RecyclerView 


private lateinit var appDatabase: AppDatabase 


override fun onCreateView(inflater: LayoutInflater, 
container: ViewGroup?, savedInstanceState: Bundle?): View { 


layout - inflater.inflate(R.layout.fragment list users, 
container, false) as LinearLayout 

bindViews () 

setupInstances () 


return layout 


} 
下 面 将 用 户 回 收视 图 绑 定 至 其 布局 元 素 上 ， 如 下 所 示 : 


override fun bindViews() { 
rvUsers = layout.findViewById(R.id.rv users) 


override fun setupInstances() ( 
appDatabase = AppDatabase.create (activity) 
rvUsers.layoutManager - LinearLayoutManager (activity) 
rvUsers.adapter - UsersAdapter (appDatabase) 


) 


private class UsersAdapter(appDatabase: AppDatabase) : 
RecyclerView.Adapter«UsersAdapter.ViewHolder»() ( 


private val users: ArrayList<User> = ArrayList() 
private val userDao: UserDao = appDatabase.userDao() 
"nmt 

populateUsers () 
} 


override fun onCreateViewHolder (parent: ViewGroup?, viewType: Int): 
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ViewHolder { 
val layout = LayoutInflater.from(parent?.context) 
-inflate(R.layout.vh user, parent, false) 
return ViewHolder (layout) 


) 


override fun onBindViewHolder (holder: ViewHolder?, position: Int) { 
val layout - holder?.itemView 
val user = users[position] 


val tvFirstName = layout?.findViewById«TextView» (R.id.tv first name) 
val tvSurname = layout?.findViewById«TextView» (R.id.tv surname) 
val tvPhoneNumber = layout?.findViewById<TextView> 

(R.id.tv phone number) 


tvFirstName?.text = "First name: ${user.firstName}" 
tvSurname?.text = "Surname: ${user.surname}" 
tvPhoneNumber?.text = "Phone number: ${user.phoneNumber}" 


//Populates users ArrayList with User objects 
private fun populateUsers() ( 
users.clear() 


下 面 获取 数据 库 用 户 表 中 的 所 有 用 户 。 当 成 功 获 取 该 列表 后 ， 可 将 列表 中 的 全 部 用 
户 对 象 添加 至 用 户 ArrayList 中 ， 如 下 所 示 : 
userDao.all() 


.subscribeOn(Schedulers.io()) 
-observeOn (AndroidSchedulers.mainThread()) 
.subscribe(( res -> 
users.addAll (res) 
notifyDataSetChanged() 
}, Throwable::printStackTrace) 


override fun getItemCount(): Int { 
return users.size 


class ViewHolder(itemView: View) : RecyclerView.ViewHolder (itemView) 
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ListUsersFragment 中 的 UsersAdapter 使 用 了 UserDao 实例 设置 其 用 户 列表 ， 这 一 操 
作 在 populateUsersO 中 完成 。 当 调用 populateUsersO 时 ， 应 用 程序 保存 的 用 户 列表 通过 调 
用 userDao.all0 被 检索 。 当 成 功 检索 到 全 部 用 户 后 , 所 有 的 User 对 象 将 添加 至 UserAdapter 
的 用 户 ArrayList 中 去 。 随 后 ， 通 过 调用 notifyDataSetChanged0， 适 配器 将 被 通知 其 数据 
集中 的 数据 发 生变 化 。 

MainActivity 自身 也 需要 稍 作 修 改 。 完 整 的 MainActivity 类 定义 如 下 所 示 : 


package com.example.roomexample.ui 


import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 


android.app.Fragment 
android.support.v7.app.AppCompatActivity 
android.os.Bundle 
android.support.v7.widget.LinearLayoutManager 
android.support.v7.widget.RecyclerView 
android.text.TextUtils 
android.view.LayoutInflater 
android.view.MenuItem 

android.view.View 

android.view.ViewGroup 

android.widget.* 

com.example.roomexample.R 
com.example.roomexample.data.AppDatabase 
com.example.roomexample.data.User 
com.example.roomexample.data.UserDao 
io.reactivex.Observable 
io.reactivex.android.schedulers.AndroidSchedulers 
io.reactivex.schedulers.Schedulers 


class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate (savedInstanceState) 
setContentView(R.layout.activity main) 
navigateToForm() 


) 


private fun showHomeButton() { 
supportActionBar?.setDisplayHomeAsUpEnabled (true) 


} 


private fun hideHomeButton() { 
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supportActionBar?.setDisplayHomeAsUpEnabled(false) 
} 


private fun navigateToForm() { 
val transaction = fragmentManager.beginTransaction() 
transaction.add(R.id.1l container, CreateUserFragment () ) 
transaction.commit () 


} 
当 用 户 单 击 返 回 按钮 时 ， 将 调用 下 列 函 数 。 如 果 片 段 回 退 栈 包 含 一 个 或 多 个 片段 ， 
片段 过 滤器 将 弹出 片段 ， 并 向 用 户 予 以 显示 ， 如 下 所 示 : 


override fun onBackPressed() ( 
if (fragmentManager.backStackEntryCount » 0) ( 
fragmentManager .popBackStack () 
hideHomeButton () 
} else { 
super .onBackPressed() 


} 


private fun navigateToList() { 
val transaction = fragmentManager.beginTransaction() 
transaction.replace(R.id.ll container, ListUsersFragment () ) 
transaction.addToBackStack (null) 
transaction.commit () 


override fun onOptionsItemSelected(item: MenuItem?): Boolean { 
val id = item?.itemId 


if (id == android.R.id.home) { 
onBackPressed() 
hideHomeButton () 


return super.onOptionsItemSelected (item) 


} 


class CreateUserFragment : Fragment(), MainView, View.OnClickListener { 
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class ListUsersFragment : Fragment(), MainView { 
} 
) 
当前 ， 需 要 运行 该 应 用 程序 ， 以 查看 是 否 按照 期 望 的 方式 运行 。 在 所 选取 的 设备 上 


构建 并 运行 该 项 目 。 当 项 目 启 动 时 ， 即 会 看 到 用 户 表单 ， 读 者 可 在 其 中 输入 用 户 信息 ， 
如 图 7.4 所 示 。 

在 向 用 户 表单 中 输入 有 效 信息 后 ， 单 击 SUBMIT 按钮 ， 并 将 该 用 户 保存 至 应 用 程序 
的 SQLite 数据 中 。 当 保存 成 功 后 , 用 户 将 会 看 到 一 条 提示 信息 。 随后 , 单 击 VIEW USERS 
按钮 可 查看 刚刚 保存 的 用 户 信息 ， 如 图 7.5 所 示 。 


Room Example 


Room Example 


Create User First name: Tobi 
Surname: Andrews 


Tobi Phone number: +14155552671 


Andrews 


+14155552671 


图 7.4 用 户 表单 图 7.5 查看 刚刚 保存 的 用 户 信息 
读者 可 查看 多 个 用 户 的 信息 ， 就 数据 库 的 容量 而 言 ， 此 类 信息 数量 并 不 存在 上 限 。 


74 与 内 容 提供 商 协同 工作 


第 
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章 曾 简要 介绍 了 内 容 提供 商 方面 的 内 容 ， 并 帮助 应 用 程序 控制 访问 数据 〈 此 类 
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数据 存储 于 当前 应 用 程序 中 或 者 是 另 一 个 App H) 。 除 此 之 外 ， 我 们 还 通过 应 用 程序 编 
程 接口 使 得 内 容 提供 商 实现 了 与 另 一 个 应 用 程序 之 间 的 数据 共享 。 
内 容 提供 商 的 行为 类 似 于 数据 库 ， 支 持 内 容 的 插入 、 删 除 、 编 辑 、 更 新 以 及 查询 操 
作 ， 对 应 方法 包括 insert0、update0、delete0 以 及 query0。 多 数 时 候 ， 由 内 容 提 供 商 控制 
的 数据 存在 于 SQLite 数据 库 中 。 

基于 应 用 程序 的 内 容 提供 商 可 通过 以 下 5 个 步骤 创建 : 

(1) 定义 扩展 了 ContentProvider 的 内 容 提供 商 类 。 

(2) 定义 内 容 URI 地 址 。 

(3) 创建 与 内 容 提供 商 交 互 的 数据 源 ， 该 数据 源 往往 以 SQLite 数据 库 这 一 形式 出 
现 。 当 SQLite 作为 数据 源 时 ， 需 要 定义 SQLiteOpenHelper， 并 履 写 其 onCreate() 方 法 ， 
进而 构建 内 容 提供 商 可 控制 的 数据 库 。 

(4) 实现 所 需 的 内 容 提供 商 方法 。 

(5) 在 项 目的 清单 文件 中 注册 内 容 提供 商 。 

综 上 所 述 ， 内 容 提 供 商 需 要 实现 6 个 方法 ， 其 中 包括 : 
onCreate(): 该 方法 调用 后 将 初始 化 数据 库 。 
queryQ: 该 方法 通过 Cursor 向 调用 方 返回 数据 。 
insert): 该 方法 被 调用 后 ， 将 向 内 容 提供 商 插入 新 的 数据 。 
delete0: 该 方法 被 调用 后 将 从 内 容 提供 商 中 删除 数据 。 
update): 该 方法 被 调用 后 ， 将 更 新 内 容 提 供 商 中 的 数据 。 
getIypeQ: 该 方法 被 调用 后 ， 将 返回 内 容 提供 商 中 的 MIME 数据 类 型 。 

为 了 确保 读者 完全 理解 内 容 提 供 商 的 工作 机 制 ， 下 面 通过 内 容 提供 商 和 SQLite 数据 
库 创建 一 个 示例 项 目 。 对 此 , 创建 一 个 名 为 ContentProvider 的 Android Studio 项 目 ， 并 将 
空 MainActivity 加 入 其 中 。 类 似 于 本 章 所 构建 的 其 他 应 用 程序 ， 当 前 示例 也 较为 简单 : 
用 户 可 在 文本 框 中 输入 产品 信息 (包括 产品 名 称 及 其 制造 商 ) ， 并 将 其 保存 至 SQLite 数 
据 库 中 。 随 后 ， 用 户 可 查看 保存 后 的 产品 信息 。 

修改 activity_main.xml 文件 ， 并 使 其 包含 以 下 XML 内 容 。 

«?xml version-"1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 

xmlns:tools-"http://schemas.android.com/tools" 

android:layout width-"match parent" 


android:layout height-"match parent" 
android:orientation-"vertical" 


DCCLDCDLC 


android:gravity-"center horizontal" 
android:padding-"16dp" 
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tools:context-"com.example.contentproviderexample.MainActivity"» 
<TextView 
android:layout width="wrap content" 
android:layout height-"wrap content" 
android:gravity-"center" 
android:text-"(string/content provider example" 
android: textColor="@color/colorAccent" 
android: textSize="32sp"/> 
<EditText 
android: id="@+id/et_product_name" 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android:layout marginTop-"16dp" 
android:hint-"Product Name"/» 
<EditText 
android: id="@+id/et_product_manufacturer" 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android:layout marginTop-"16dp" 
android:hint-"Product Manufacturer"/» 
«Button 
android: id="@+id/btn_add_product" 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android:layout marginTop-"16dp" 
android:text-"Add product"/» 
«Button 
android:id-"G*id/btn show products" 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android:layout marginTop-"16dp" 
android:text-"Show products"/» 
</LinearLayout> 


在 经 过 上 述 调整 后 ， 可 将 下 列 字 符 串 资源 添加 至 项 目的 strings.xml 文件 中 。 
<string name="content provider example">Content Provider Example</string> 


下 面 在 com.example.contentproviderexample 包 中 创建 文件 ， 并 添加 下 列 代码 : 


package com.example.contentproviderexample 


import android.content.* 
import android.database.Cursor 
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import 
import 
import 
import 
import 
import 


android.database.SQLException 
android.database.sqlite.SQLiteDatabase 
android.database.sqlite.SQLiteOpenHelper 
android.database.sqlite.SQLiteQueryBuilder 
android.net.Uri 

android.text.TextUtils 


internal class ProductProvider : ContentProvider() ( 


companion object { 


val 


val 
val 


val 
val 


PROVIDER NAME: String = "com.example.contentproviderexample 
.ProductProvider" 

URL: String = "content://$PROVIDER NAME/products" 

CONTENT URI: Uri = Uri.parse (URL) 


PRODUCTS = 1 
PRODUCT ID - 2 


// Database and table property declarations 


val 
val 
val 


// 

val 
val 
val 
val 
val 


DATABASE VERSION = 1 
DATABASE NAME = "Depot" 
PRODUCTS TABLE NAME - "products" 


"products' table column name declarations 

tD: String = "id" 

NAME: String = "name" 

MANUFACTURER: String = "manufacturer" 

uriMatcher: UriMatcher = UriMatcher (UriMatcher.NO MATCH) 
PRODUCTS PROJECTION MAP: HashMap<String, String> = HashMap () 


SQLiteOpenHelper 类 负责 创建 内 容 提 供 商 的 数据 库 ， 如 下 所 示 : 


private class DatabaseHelper(context: Context) : 
SQLiteOpenHelper(context, DATABASE NAME, null, 
DATABASE VERSION) { 


override fun onCreate(db: SQLiteDatabase) { 


val query = " CREATE TABLE " + PRODUCTS TABLE NAME + 
" (id INTEGER PRIMARY KEY AUTOINCREMENT, " + 
" name VARCHAR(255) NOT NULL, " + 
" manufacturer VARCHAR(255) NOT NULL);" 
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db.execSQL (query) 
b 


override fun onUpgrade(db: SQLiteDatabase, oldVersion: Int, 
newVersion: Int) { 
val query = "DROP TABLE IF EXISTS $PRODUCTS TABLE NAME" 


db.execSQL (query) 
onCreate (db) 
) 


private lateinit var db: SQLiteDatabase 


override fun onCreate(): Boolean { 
uriMatcher.addURI (PROVIDER NAME, "products", PRODUCTS) 
uriMatcher.addURI (PROVIDER NAME, "products/#", PRODUCT ID) 


val helper - DatabaseHelper (context) 
下 面 利 用 SQLiteOpenHelper 获取 可 写 入 的 数据 库 。 如 果 数 据 库 尚未 创建 ， 下 列 代 码 
将 创建 一 个 新 的 数据 库 。 


db = helper.writableDatabase 


return true 


override fun insert(uri: Uri, values: ContentValues): Uri ( 
//Insert a new product record into the products table 
val rowId - db.insert(PRODUCTS TABLE NAME, "", values) 


//If rowId is greater than 0 then the product record was added 
//successfully. 
if (rowId » 0) ( 
val uri - ContentUris.withAppendedId(CONTENT URI, rowId) 
context.contentResolver.notifyChange( uri, null) 


return uri 


// throws an exception if the product was not successfully added. 
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throw SQLException("Failed to add product into " + uri) 


override fun query(uri: Uri, projection: Array<String>?, 
selection: String?, selectionArgs: Array<String>?, 


sortOrder: String): Cursor ( 


val queryBuilder = SQLiteQueryBuilder () 
queryBuilder.tables - PRODUCTS TABLE NAME 


when (uriMatcher.match(uri)) { 
PRODUCTS -> 
queryBuilder.setProjectionMap (PRODUCTS PROJECTION MAP) 
PRODUCT ID -> queryBuilder.appendWhere ( 
"SID = $(uri.pathSegments [1] ) " 


val cursor: Cursor - queryBuilder.query(db, projection, selection, 
selectionArgs, null, null, sortOrder) 


cursor.setNotificationUri(context.contentResolver, uri) 
return cursor 


override fun delete(uri: Uri, selection: String, 
selectionArgs: Array<String>): Int { 


val count = when(uriMatcher.match(uri)) { 


PRODUCTS -> db.delete (PRODUCTS TABLE NAME, selection, selectionArgs) 
PRODUCT ID -> { 
val id = uri.pathSegments[1] 
db.delete (PRODUCTS TABLE NAME, "$ID = $id " + 
if (!TextUtils.isEmpty(selection)) "AND 
($selection)" else "", selectionArgs) 
} 
else -> throw IllegalArgumentException("Unknown URI: Suri") 


} 


context .contentResolver.notifyChange (uri, null) 


return count 
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override fun update(uri: Uri, values: ContentValues, selection: String, 
selectionArgs: Array<String>): Int { 


val count - when(uriMatcher.match(uri)) ( 
PRODUCTS -> db.update(PRODUCTS TABLE NAME, values, 
selection, selectionArgs) 
PRODUCT ID -> { 
db.update (PRODUCTS TABLE NAME, values, 
"SID = $(uri.pathSegments[1]) " + 
if (!TextUtils.isEmpty(selection)) " AND 
($selection)" else "", selectionArgs) 
} 
else -> throw IllegalArgumentException ("Unknown URI: Suri") 
} 


context.contentResolver.notifyChange(uri, null) 
return count 


override fun getType(uri: Uri): String { 
//Returns the appropriate MIME type of records 


return when (uriMatcher.match (uri) ) { 
PRODUCTS -> "vnd.android.cursor.dir/vnd.example.products" 
PRODUCT ID -> "vnd.android.cursor.item/vnd.example.products" 
else -> throw IllegalArgumentException("Unpermitted URI: " + uri) 
} 


} 


再 加 入 相应 的 ProductProvider， 并 提供 与 保存 后 的 产品 相关 的 内 容 后 ， 还 需要 在 
AndroidManifest 文件 中 注册 新 的 组 件 。 下 列 代码 片段 向 清单 文件 中 添加 了 当前 提供 商 。 


<?xml version-"1.0" encoding-"utf-8"?» 
«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"com.example.contentproviderexample"» 


«application 
android:allowBackup-"true" 
android: icon="@mipmap/ic_launcher" 
android: label="@string/app_name" 
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android:roundIcon="@mipmap/ic launcher round" 
android:supportsRtl-"true" 
android: theme="@style/AppTheme"> 
<activity android:name=".MainActivity"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 


<category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
<provider android:authorities="com.example.contentproviderexample 
-ProductProvider" android:name="ProductProvider"/> 
</application> 


</manifest> 


下 面 修改 MainActivity 并 使 用 新 注册 的 提供 商 。 调整 MainActivity.kt 文件 , 并 包含 下 
列 代 码 : 


package com.example.contentproviderexample 


import android.content.ContentValues 

import android.net.Uri 

import android.support.v7.app.AppCompatActivity 
import android.os.Bundle 

import android.text.TextUtils 

import android.view.View 

import android.widget.Button 

import android.widget.EditText 

import android.widget.Toast 


class MainActivity : AppCompatActivity(), View.OnClickListener ( 


private lateinit var etProductName: EditText 

private lateinit var etProductManufacturer: EditText 
private lateinit var btnAddProduct: Button 

private lateinit var btnShowProduct: Button 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate (savedInstanceState) 
setContentView(R.layout.activity main) 
bindViews () 
setupInstances () 
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private fun bindViews() ( 
etProductName = findViewById(R.id.et product name) 
etProductManufacturer = findViewById(R.id.et product manufacturer) 
btnAddProduct = findViewById(R.id.btn add product) 
btnShowProduct = findViewById(R.id.btn show products) 


private fun setupInstances() ( 
btnAddProduct.setOnClickListener (this) 
btnShowProduct.setOnClickListener (this) 
supportActionBar?.hide() 


private fun inputsValid(): Boolean ( 
var inputsValid - true 
if (TextUtils.isEmpty(etProductName.text)) { 
etProductName.error - "Field required." 
etProductName.requestFocus () 
inputsValid - false 


else if (TextUtils.isEmpty(etProductManufacturer.text)) { 
etProductManufacturer.error = "Field required." 
etProductManufacturer.requestFocus() 

inputsValid = false 


return inputsValid 
private fun addProduct() ( 
val contentValues = ContentValues() 
contentValues.put (ProductProvider.NAME, etProductName.text.toString()) 
contentValues. put (ProductProvider .MANUFACTURER, 
etProductManufacturer.text.toString()) 


contentResolver.insert (ProductProvider.CONTENT URI, contentValues) 


showSaveSuccess () 
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当 调用 下 列 函 数 时 ， 将 显示 数据 库 中 的 对 应 产品 。 


private fun showProducts() { 
val uri = Uri.parse(ProductProvider.URL) 


val cursor = managedQuery(uri, null, null, null, "name") 
if (cursor !- null) ( 
if (cursor.moveToFirst()) ( 
do ( 
val res = "ID: $(cursor.getString(cursor.getColumnIndex 


(ProductProvider.ID))}" + ", 

\nPRODUCT NAME: ${cursor.getString (cursor.getColumnIndex 
( ProductProvider.NAME)))" + ", 

\nPRODUCT MANUFACTURER: $(cursor.getString (cursor.getColumnIndex 
(ProductProvider.MANUFACTURER))]" 


Toast.makeText(this, res, Toast.LENGTH LONG).show() 
) while (cursor.moveToNext () ) 
} 
) else ( 
Toast.makeText(this, "Oops, something went wrong.", 
Toast.LENGTH LONG).show() 


} 


private fun showSaveSuccess() { 
Toast.makeText (this, "Product successfully saved.", 
Toast .LENGTH_LONG) . show () 


} 


override fun onClick(view: View) { 
val id = view.id 


if (id == R.id.btn_add_ product) { 
if (inputsValid()) { 
addProduct () 


} 
) else if (id == R.id.btn show products) { 


showProducts() 
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在 上 述 代 码 中 , 应 注意 addProduct0 和 showProducts0 〇 这 两 个 方法 。 FLA, addProduct() 
将 产品 数据 存储 于 contentValues 实例 中 ， 并 于 随后 借助 于 ProductProvider 将 该 信息 插入 
SQLite 数 据 库 中 , 即 调用 contentResolver.insert(ProductProvider. CONTENT _URLcontentValues) 
方法 。showProducts0 则 使 用 Cursor 显示 于 存储 于 数据 库 中 的 产品 信息 。 

下 面 构建 并 运行 该 应 用 程序 。 启 动 程序 后 ， 用 户 将 被 转 至 MainActivity， 并 显示 一 个 


表单 ， 等 待 用 户 输入 产品 名 称 及 其 制造 商 ， 如 图 7.6 所 示 。 


插入 应 用 程序 SQLite 数据 库 的 产品 表 中 。 此 外 ， 还 可 在 当前 表 生 
单 击 SHOW PRODUCTS 按钮 ， 如 图 7.7 所 示 。 


Content Provider Example 


Infinity Phone 10 Infinity Phone 10 


Content Provider Example 


当 输 入 有 效 的 产品 信息 后 ,， 单 击 ADD PRODUCT 按钮 。 该 产品 将 作为 一 条 新 的 记录 


中 添加 新 的 产品 项 ， 并 


Infinity Inc. Infinity Inc] 


图 7.6 用 户 输入 产品 名 称 及 其 制造 商 图 7.7 在 当前 表 


单 中 添加 新 的 产品 项 


上 述 操作 将 调用 MainActivity 中 的 showProducts0。 随 后 ， 全 部 产品 记录 将 被 检索 并 


逐一 显示 。 


本 章 讨论 了 内 容 提 供 商 的 工作 机 制 ， 读 者 可 尝试 添加 、 更 新 


和 删除 产品 记录 等 功能 ， 


进而 完善 该 应 用 程序 。 对 于 读者 来 说 ， 这 也 是 一 次 极 好 的 实践 机 会 。 
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75 本 章 小 结 


本 章 介 绍 了 Android 应 用 程序 框架 所 支持 的 各 种 数据 存储 方式 ,包括 内 部 存储 和 外 部 
存储 ， 进 而 实现 私有 和 公共 文件 中 的 数据 存储 。 除 此 之 外 ， 我 们 还 学 习 了 如 何 借助 于 内 
部 存储 和 外 部 存储 与 缓存 文件 协同 工作 。 

同时 ， 本 章 还 深入 讨论 了 SQLite RDBMS 及 其 在 Android 应 用 程序 中 的 应 用 方式 。 
例如 ， 利 用 Room 检索 和 存储 SQLite 数据 库 中 的 数据 。 接 下 来 还 探讨 了 如 何 通过 SQLite 
数据 库 〈 作 为 底层 数据 存储 ) 并 使 用 内 容 提供 商 控制 数据 的 访问 。 

第 8 章 将 讨论 Android 应 用 程序 框架 中 Android 应 用 程序 安全 和 部 署 方面 的 问题 。 


#88 Android App 的 安全 和 部 署 


前 述 章节 讨论 了 Kotlin 语言 在 移动 App 领域 中 的 应 用 ， 以 及 Android 应 用 程序 框架 
中 所 支持 的 各 类 存储 媒介 ， 包 括 内 部 存储 、 外 部 存储 、 网 络 存 储 以 及 SQLite， 并 构建 了 
大 量 的 应 用 示例 。 其 中 涉及 基于 Room 和 内 容 提供 商 的 SQLite 数据 库 中 的 数据 存储 和 检 
索 方法 。 

本 章 主要 涉及 以 下 两 项 较为 重要 的 内 容 : 
O Android 应 用 程序 安全 。 
口 Android 应 用 程序 部 署 。 


8.1 Android 应 用 程序 安全 


在 软件 的 构建 过 程 中 , 安全 一 直 是 一 类 重要 的 问题 。 除 了 Android 操作 系统 中 的 安全 
措施 之 外 ， 开 发 人 员 还 应 确保 应 用 程序 符合 既定 的 安全 标准 。 在 本 节 中 ， 我 们 将 对 一 些 
要 的 安全 性 考虑 事项 和 最 佳 实践 进行 分 析 ， 以 供 读者 深入 理解 安全 性 问题 。 据 此 ， 可 
确保 应 用 程序 避免 遭受 到 客户 端 设 备 上 的 恶意 程序 的 攻击 。 


8.1.1 内 部 存储 


在 条 件 均等 的 情况 下 ， 对 于 应 用 程序 保存 到 设备 上 的 数据 ， 隐 私 性 是 开发 Android 
应 用 程序 时 最 常见 的 安全 问题 。 对 此 ， 可 以 遵循 一 些 简 单 的 规则 ， 以 使 应 用 程序 数据 更 
加 安全 。 

1. 使 用 内 部 存储 


如 前 所 述 , 内 部 存储 是 在 设备 上 保存 私有 数据 的 一 种 较 好 方式 。 每 个 Android 应 用 程 
序 都 设置 了 一 个 相应 的 内 部 存储 目录 ， 可 以 在 其 中 创建 和 写 入 私有 文件 。 这 些 文件 是 构 
建 应 用 程序 的 私有 文件 ， 因 此 客户 端 设备 上 的 其 他 应 用 程序 不 能 访问 这 些 文件 。 
根据 经 验 ， 如 果 应 用 程序 只 能 访问 数据 ， 并 且 可 以 合理 地 将 数据 存储 在 内 部 存储 中 ， 
那么 就 秉承 这 一 原则 。 读 者 可 参考 第 7 章 以 了 解 如 何 使 用 内 部 存储 。 


limi 
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2. 使 用 外 部 存储 

外 部 存储 文件 并 不 是 应 用 程序 的 私有 文件 ， 因 此 ， 可 以 由 同一 客户 端 设备 上 的 其 他 
应 用 程序 轻松 地 加 以 访问 。 因 此 ， 在 将 应 用 程序 数据 存储 到 外 部 存储 之 前 ， 应 考虑 对 其 
进行 加 密 。 在 将 数据 保存 到 外 部 存储 之 前 ， 可 以 使 用 许多 库 和 包 对 数据 进行 加 密 。 例 如 ， 
对 于 外 部 存储 数据 加 密 ，Facebook 的 Conceal Æ Chttp://facebook.github.io/conceal/) 是 一 
个 较 好 的 选择 方案 。 

此 外 ， 作 为 另 一 个 经 验 法 则 ， 不 要 在 外 部 存储 中 存储 敏感 数据 ， 以 防止 外 部 存储 文 
件 被 他 人 操控 。 同 时 ， 还 应 该 对 外 部 存储 检索 的 输入 内 容 进行 验证 。 这 种 验证 是 针对 外 
部 存储 中 非 受信 数据 的 一 种 防范 措施 。 

3. 内 容 提供 商 

如 前 所 述 ， 内 容 提供 商 可 阻止 或 启用 应 用 程序 数据 的 外 部 访问 。 当 在 清单 文件 中 注 
册 内 容 提供 商 时 , 可 使 用 android:exported 属性 确定 是 否 允 许 对 内 容 提供 商 进 行 外 部 访问 。 
若是 ， 则 将 android:exported 设置 为 true; 否则 将 其 设置 为 false. 

除 此 之 外 ， 内 容 提供 商 中 的 查询 方法 还 可 用 于 防止 SQL 注入 〈 即 攻击 者 在 输入 字段 
中 执行 恶意 SQL 语句 的 代码 注入 技术 ) ， 例 如 query). update) fll delete0 方 法 。 


8.1.2 网络 安全 


在 通过 Android 应 用 程序 执行 网 络 事务 时 , 应 该 遵循 一 些 最 佳 实践 方案 , 相关 方案 可 
划分 为 不 同 的 类 别 。 本 节 将 讨论 互联 网 协议 CIP) 网 络 和 电话 网 络 。 

1. IP 网 络 

当 通 过 IP 与 远程 计算 机 通信 时 ， 应 确保 应 用 程序 尽 可 能 地 使 用 HTTP (〈 因 此， 服务 
器 均 支持 HITP) 。 这 样 做 的 一 个 主要 原因 是 ， 设 备 经 常会 连接 到 不 安全 的 网 络 ， 例 如 公 
共 无 线 连 接 。HTTP 可 确保 客户 端 和 服务 器 之 间 的 加 密 通信 ， 而 不 考虑 所 连接 的 网 络 。 在 
Java 中 ，HttpsURLConnection 可 以 用 于 网 络 上 的 安全 数据 传输 。 值 得 注意 的 是 ， 通 过 不 
安全 的 网 络 连 接 接收 的 数据 不 应 予以 信任 。 

2. 电话 网 络 

当 需 要 在 服务 器 和 客户 端 应 用 程序 之 间 自 由 传输 数据 的 情况 下 ， 应 该 使 用 Firebase 
云 消息 传递 (FCM) UR IP 网 络 ， 而 不 是 使 用 其 他 方案 ， 例 如 短 消息 传递 服务 CSMS) 
协议 。FCM 是 一 种 多 平台 的 消息 传递 解决 方案 ， 并 有 助 于 在 应 用 程序 之 间 无 终 、 可 靠 地 
传输 消息 。 
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对 于 数据 消息 传输 ，SMA 并 不 是 一 种 较 好 的 候选 方案 ， 其 原因 包括 : 
QO 未 采用 加 密 操作 。 

O 未 经 过 强 认证 。 

O 通过 SMS 发 送 的 消息 可 能 受到 欺骗 。 

口 SMS 消息 可 能 被 拦截 。 


8.1.3 输入 验证 


用 户 的 输入 验证 十 分 重要 ， 进 而 可 避免 可 能 出 现 的 安全 风险 ，SQL 注入 便 是 其 中 之 
一 。 对 此 ， 可 通过 参数 化 查询 以 及 在 原始 SQL 查询 中 使 用 输入 过 滤 来 防止 恶意 的 SQL 
脚本 注入 。 

除 此 之 外 , 源 自 外 部 存储 的 输入 还 需 执 行 验证 操作 一 一 外 部 存储 并 非 是 受信 数据 源 。 


8.14 与 用 户 赁 证 协同 工作 


通过 减少 对 应 用 程序 中 用 户 赁 证 输入 的 要 求 ， 可 以 降低 钓鱼 攻击 的 风险 。 与 其 不 断 
地 请 求 用 户 凭证 ， 不 如 考虑 使 用 授权 令 牌 。 其 中 ， 用 户 不 需要 在 设备 上 存储 用 户 名 和 密 
码 。 相 反 ， 可 使 用 更 新 的 授权 令 牌 。 


8.1.5 代码 混淆 技术 


在 发 布 Android 应 用 程序 之 前 ， 必 须 使 用 代码 混淆 工具 〈 如 ProGuard) ， 以 防止 他 人 利 
用 各 种 方法 (如 反 编 译 ) 不 受 限制 地 访问 源 代码 。 ProGuard 是 在 Android SDK 中 预 置 打 包 的 
工具 ， 因 此 不 需要 包含 依赖 项 。 如 果 用 户 将 构建 类 型 指定 为 发 布 ， 那 么 它 将 自动 包含 在 构建 
过 程 中 。 关 于 ProGuard 的 更 多 内 容 ， 读 者 可 访问 https://www.guardsquare.com/en/proguard. 


8.1.6 ”广播 接收 器 的 安全 性 

默认 情况 下 ， 广 播 接收 器 组 件 将 被 导出 ， 因 此 可 以 在 同一 设备 上 被 其 他 应 用 程序 调 
用 。 通 过 安全 权限 ， 可 控制 应 用 程序 对 广播 接收 器 的 访问 。 对 此 ， 可 在 应 用 程序 清单 文 
件 中 利用 <receiver> 元 素 设置 广播 接收 器 的 权限 。 
84.7 ”动态 加 载 代 码 


当 应 用 程序 需要 动态 加 载 代码 时 ， 必 须 确保 所 加 载 的 代码 来 自 受 信任 的 源 代码 。 除 


*310* Kotlin 语言 实例 精 解 


此 之 外 ， 还 必须 确保 不 惜 任何 代价 降低 自 改 代码 的 风险 。 加 载 和 执行 被 算 改 的 代码 是 一 
种 巨大 的 安全 威胁 。 当 从 远程 服务 器 加 载 代码 时 ， 应 确保 它 通 过 安全 、 加 密 的 网 络 传输 。 
请 记 住 ， 动 态 加 载 的 代码 运行 时 具有 与 应 用 程序 相同 的 安全 权限 (应 用 程序 清单 文件 中 
定义 的 权限 ) 。 


8.1.8 服务 的 安全 性 


与 广播 接收 器 不 同 ，Android 系统 默认 状态 下 不 导出 服务 。 仅 当 Intent 过 滤器 添加 至 
清单 文件 中 的 服务 声明 时 , 才 会 出 现 默认 的 服务 导出 行为 。 对 此 , 应 使 用 android:exported 
属性 确保 只 在 需要 服务 时 才 导 出 服务 。 当 需要 导出 服务 时 ， 可 将 android:exported 设置 为 
true, AMAA false. 


82 ”启用 和 发 布 Android 应 用 程序 


截至 目前 ， 本 章 前 述 内 容 介绍 了 Android 中 的 系统 、 应 用 程序 、 开 发 、 安 全 特性 等 内 
容 。 下 面 探讨 Android 应 用 程序 的 启动 和 发 布 。 

读者 可 能 会 对 此 处 的 术语 启用 和 发 布 有 所 疑惑 。 启 用 表示 为 一 个 活动 , 并 向 公众 ( 终 
端 用 户 ) 引入 新 产品 ; 而 发 布 Android 应 用 程序 仅 是 简单 地 令 该 程序 对 用 户 可 用 。 相应 地 ， 
需要 执行 各 种 活动 和 处 理 过 程 以 确保 成 功 地 启用 Android 应 用 程序 ,此 处 共计 15 种 活动 ， 
如 下 所 示 : 

O ”理解 Android 开发 者 程序 策略 。 

口 设置 Android 开发 者 账户 。 

O ”本 地 化 规划 。 

Q ”规划 同步 版 本 。 

口 根据 质量 标准 进行 测试 。 

口 ”构建 可 发 布 的 APK。 

口 ” 规 划 应 用 程序 的 Play Store 列表 。 

O ”将 应 用 程序 包 上 传 至 alpha 或 beta 测试 。 

口 ”设备 兼容 性 定义 。 

O ”启用 前 报告 评估 。 

O “定价 和 应 用 程序 分 发 配置 。 

O “分 发 选项 的 选取 。 
O “应 用 程序 内 产品 和 订阅 设置 。 
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OQ ”制定 应 用 程序 内 容 评级 。 
O “发布 应 用 程序 。 

这 是 一 份 长 长 的 名 单 。 如 果 读 者 尚 不 理解 清单 中 的 所 有 内 容 ， 不 要 担心 ， 下 面 让 我 
们 详细 地 查看 每 一 项 内 容 。 


8.2.1 理解 Android 开发 者 程序 策略 

制定 开发 者 程序 策略 的 唯一 宗旨 是 确保 Play Store 仍然 是 用 户 受信 的 软件 源 。 违 反 这 
些 政策 会 带 来 一 定 的 后 果 。 因 此 ， 在 启动 应 用 程序 之 前 ， 仔 细 阅 读 并 充分 理解 这 些 开发 
人 员 策 略 〈 其 目的 和 结果 ) 是 非常 重要 的 。 


8.2.2 设置 Android 开发 者 账号 


读者 需要 设置 一 个 Android 开发 人 员 账 号 ， 进 而 在 Play Store 上 启用 应 用 程序 ， 同 时 
还 应 确保 账号 细节 的 准确 性 。 另外， 如果 需 要 在 Android 应 用 程序 上 销售 产品 , 还 需要 设 
置 一 个 商业 账号 。 


8.23 本 地 化 规划 


某 些 时候 ， 出 于 本 地 化 的 目的 ， 用 户 可 能 持 有 多 个 应 用 程序 副本 ， 每 个 副本 都 本 地 
化 为 不 同 的 语言 。 在 这 种 情况 下 ， 需 要 尽早 地 计划 本 地 化 操作 , 并 遵循 Android 开发 人 员 
推荐 的 本 地 化 检查 表 。 关 于 本 地 化 检查 表 ， 读 者 可 访问 https://developer.android.com/ 
distribute/best-practices/launch/localization-checklist.html 获取 更 多 内 容 。 


8.2.4 规划 同步 版 本 

用 户 可 能 希望 在 多 个 平台 上 发 布 产 品 ， 其 中 包含 了 诸多 优点 ， 如 增加 产品 的 潜在 市 
场 规模 ， 减 少 对 产品 的 访问 壁垒， 以 及 最 大 化 应 用 程序 的 潜在 安装 数量 。 同 时 在 多 个 平 
台 上 发 布 产品 通常 是 一 种 较 好 的 做 法 。 对 此 ， 应 确保 提前 做 好 计划 。 如 果 无 法 在 多 个 平 


台 上 启用 应 用 程序 ， 应 确保 提供 某 种 方式 ， 以 使 潜在 用 户 可 提交 他 们 的 联系 方式 。 一 旦 
产品 在 平台 上 被 选用 ， 可 确保 与 其 进行 联系 。 


8.2.5 根据 质量 标准 进行 测试 


测试 标准 提供 了 一 种 测试 模板 , 以 确认 应 用 程序 满足 Android 用 户 期 望 的 基本 功能 和 
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非 功能 需求 。 在 启用 之 前 ， 应 确保 参照 这 些 质量 标准 运行 应 用 程序 。 
8.2.6 构建 可 发 布 的 APK 


可 发 布 的 APK 是 一 个 Android 应 用 程序 ， 它 经 过 优化 打包 ， 然 后 使 用 发 布 密 钥 进行 
构建 和 签名 。 构 建 一 个 可 发 布 的 APK 是 Android 应 用 程序 发 布 的 一 个 重要 步 又， 读者 应 
对 此 予以 足够 的 重视 。 


8.2.7 ”规划 应 用 程序 的 Play Store 列表 


对 于 Play Store 清单 ， 这 一 步 又 涉及 产品 资源 列表 。 这些 资 源 包括 但 不 限于 应 用 程序 
的 日 志 、 屏 幕 截图 、 描 述 、 推 广 图 形 和 视频 〈 若 存在 ) 。 另 外 ， 确 保 将 应 用 程序 的 隐私 
策略 与 应 用 程序 的 Play Store 列表 连接 在 一 起 。 同 时 ， 将 应 用 程序 的 产品 列表 本 地 化 为 应 
用 程序 支持 的 所 有 语言 也 很 重要 。 


8.2.8 将 应 用 程序 包 上 传 至 alpha 或 beta 测试 


测试 是 检测 软件 缺陷 和 提高 软件 质量 的 一 种 有 效 方法 ， 一 种 较 好 的 做 法 是 将 应 用 程 
序 包 上 传 到 alpha 和 beta 测试 ， 以 便 针 对 产品 进行 apha 和 beta 软件 测试 。 另 外 ，alpha 
测试 和 beta 测试 都 是 验收 型 测试 。 


8.2.9 设备 兼容 性 定义 


这 一 步骤 涉及 应 用 程序 开发 过 程 中 Android 版 本 和 屏幕 尺寸 的 声明 。 在 这 一 步骤 中 ， 
应 尽 可 能 准确 地 定义 Android 版 本 和 屏幕 尺寸 , 这 一 点 非常 重要 ; 否则 将 导致 用 户 体验 方 
面 的 问题 。 


8.2.10 ”启用 前 报告 评估 


启用 前 报告 评估 用 于 识别 Android 设备 上 的 应 用 程序 在 自动 测试 后 所 产生 的 问题 ,在 
将 一 个 应 用 程序 包 上 传 到 alpha 或 beta 测试 时 , 如果 选择 该 项 功能 , 用 户 将 会 得 到 启用 前 
的 报告 评估 结果 。 


8.2.11 ”定价 和 应 用 程序 分 发 配置 
首先 ， 需 要 确定 应 用 程序 的 定价 方法 。 此 后 ， 可 将 应 用 程序 设置 为 免费 安装 或 付费 
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下 载 。 在 应 用 程序 价格 制定 完毕 后 ， 可 选择 应 用 程序 分 发 的 国家 。 
8.2.12 ”分 发 选项 的 选取 


这 一 步 涉及 应 用 程序 发 布 时 设备 和 平台 的 选择 一 一 例如 ，Android TV 和 Android 
Wear. 在 此 之 后 ， 谷 歌 Play 团队 将 对 应 用 程序 进行 审查 。 若 审核 通过 ，Google Play 将 会 
使 该 应 用 程序 排 位 更 加 靠 前 。 


8.213 ”应 用 程序 内 产品 和 订阅 设置 


如 果 和 希望 在 应 用 程序 内 销售 产品 ， 则 需要 设置 应 用 程序 中 的 产品 和 订阅 功能 。 其 中 ， 
可 指定 所 销售 的 国家 ， 并 处 理 与 货币 相关 的 各 种 问题 ， 例 如 税金 问题 。 在 该 步骤 中 ， 用 
户 还 将 建立 个 人 商业 账户 。 


82.14 制定 应 用 程序 内 容 评级 


读者 需要 针对 Play Store 发 布 的 应 用 程序 提供 准确 的 评级 。 这 一 步骤 是 由 Android 开 
发 者 程序 策略 所 规定 的 ， 以 帮助 目标 群体 更 容易 地 发 现 读者 的 应 用 程序 。 


8.2.15 发 布 应 用 程序 


当 完 成 了 上 述 各 步骤 后 ， 即 可 向 Play Store 发 布 应 用 程序 。 首 先 ， 读 者 需要 发 布 一 个 
软件 版 本 ， 并 可 上 传 应 用 程序 的 APK 文件 ， 同 时 跟踪 该 应 用 程序 的 定位 。 在 发 布 过 程 的 
结束 阶段 ， 读 者 可 单 击 Confirm rollout 按钮 发 布 应 用 程序 。 

至 此 ， 读 者 已 经 了 解 了 Play Store 中 应 用 程序 的 发 布 过 程 。 多 数 时 候 ， 我们 并 不 需要 
执行 全 部 操作 ， 仅 需 关 注 与 所 发 布 的 应 用 程序 相关 的 类 型 即 可 。 下 面 尝 试 发 布 第 7 章 中 
开发 的 一 款 应 用 程序 ， 即 Messenger 应 用 程序 。 如 果 读 者 愿意 的 话 ， 也 可 发 布 前 述 章 节 中 
的 任意 一 款 应 用 程序 。 

在 将 Messenger 应 用 程序 发 布 至 Play Store 时 ， 首 先 需要 注册 一 个 Google Play 开发 
人 员 账 号 。 对 此 , 可 打开 相应 的 浏览 器 , 并 访问 https://play.google.com/apps/publish/signup。 

在 开启 相关 网 页 后 , 读者 将 被 提示 输入 Google 账号 , 随后 可 接受 开发 人 员 程 序 协 议 ， 
如 图 8.1 所 示 。 

读者 可 移 至 页 面 下 方 ， 并 接受 Google Play 开发 人 员 协 议 ， 随 后 选中 I agree and I am 


willing to associate my account registration with the Google Play Developer distribution 


*314* Kotlin 语言 实例 精 解 


agreement 复 选 框 ， 如 图 8.2 所 示 。 


Google Play Console 


© 9 o 


Sign-in with your Google ‘Accept Developer Pay Registration 
‘account ‘Agreement Fee details 


You are signed in as... 


This is the Google account that will be associated with your Developer Console. 
‘organization, consider registering a new Google account rather than using a personal account 


SIGN IN WITH A DIFFERENT ACCOUNT CREATE A NEW GOOGLE ACCOUNT 


图 8.1 接受 开发 人 员 程 序 协议 


Before you continue... 


B (5 9) = 


Developer datributlon agreement 


Complete your Account 


If you would like to use a different account, you can choose from the following options below. If you are an 


Accept developer agreement Review distribution countries Credit card 
Read ar to the Google Play Developer Review the distribution countries where you Make sure you have your credit card 
distribution agreement. can distribute and sell applications. handy to pay the $25 registration 
Mf you are planning to sell apps or in-epp fee in the next step. 
E soree and a witing to associate my products, check f you can have a merchant 
account elation with the Google Pay Esci jor oar 


CONTINUE TO PAYMENT 


© 2017 Google - Mobile App - Help - Site Terms - Privacy 


图 8.2 选中 Iagree and I am willing to associate my account registration with the Google Play Developer 


distribution agreement 42 i HE 


it CONTINUE TO PAYMENT #4, Fela 


在 接受 了 协议 后 ， 
应 地 ， 用 户 需 要 一 次 


开发 人 员 账 号 。 相 


单 
性 地 交付 25 美元 的 注册 费用 。 待 付费 成 功 后 ， 将 提示 如 图 8.3 所 示 
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加 vour payment is complete 


You will receive a receipt by email. 


-à-x.R. As 


图 8.3 付费 成 功 信息 
接 下 来 ， 单 击 CONTINUE REGISTRATION 按钮 将 来 到 注册 过 程 中 的 最 后 一 步 。 其 
1， 用 户 需 要 完善 一 些 个 人 信息 ， 如 图 8.4 所 示 。 


Just complete the following details. You can change this information later in your account settings If you need to 


Developer Profile Fields marked with * need to be filed before saving. 


Developer name * 


14/50 
The developer name will appear to users under the name of your application. 


Email address * 
Website 
Phone Number * 
Include plus sign, country code and area code. For example, +1-800-555-0199, 
Why do we ask for your phone number? 
Email preferences. 


图 td ike to get new feature announcements and tips to help improve my apps. 
E rd like 10 give feedback to help improve the Google Play Developer Console. 


COMPLETE REGISTRATION 


图 8.4 完善 个 人 信息 
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读者 需要 输入 账号 所 需 的 一 些 细节 信息 ， 随 后 单 击 COMPLETE REGISTRATION 按 
钮 完成 账号 的 注册 过 程 。 

在 完成 了 注册 后 ， 读 者 转 至 Google Play Console 页 面 ， 并 于 其 中 管理 应 用 程序 、 使 
用 Google Play 服务 、 管 理 账单 、 下 载 应 用 程序 报告 、 查 看 提示 消息 ， 以 及 管理 控制 台 设 
置 ， 如 图 8.5 所 示 。 


BE Google Pay Console = Welcome Q sen 


B® All applications 


FA Game services 
E Order management o E 4 OD 
E Download reports 
A Aerts 
If you need help with the details, have a look at the ‘Add social gaming features to your games on 
K settings Getting started guide Android, IOS and the web. Learn more 
[1] = 
nt 
2i we 
"Ww 
Are you working in a team? I you are planning to create paid apps or in-app 
Invite co workers to the Developer Console. products, youll need to set up a merchant account. 


图 8.5 Google Play Console 页 面 

鉴于 当前 仅 关注 Android 应 用 程序 的 发 布 流程 ， 因 而 可 单 击 控制 台面 板 上 的 
PUBLISH AN ANDROID APP ON GOOGLE PLAY 按钮 ， 选 取 默 认 的 语言 ， 并 输入 
Messenger 作为 应 用 程序 的 标题 ， 随 后 单 击 CREATE 按钮 。 接 下 来 ， 将 在 Developer 控制 
台中 创建 如 图 8.6 所 示 的 应 用 程序 。 

在 发 布 应 用 程序 之 前 ， 还 需要 针对 Messenger 应 用 程序 签署 所 发 布 的 APK。 

打开 Android Studio 中 的 Messenger 应 用 程序 项 目 ，Android Studio 可 用 于 注册 
Messenger App， 虽 然 这 并 非 是 唯一 的 签署 方法 。 首 先 ， 可 在 Android Studio 终端 中 运行 
下 列 命令 ， 以 生成 签署 私 钥 。 


keytool -genkey -v -keystore my-release-key.jks -keyalg RSA -keysize 2048 - 
validity 10000 -alias my-alias 


执行 上 述 命令 将 提示 用 户 输入 keystore 密码 ， 并 提供 与 密 钥 相 关 的 一 些 附加 信息 。 
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随后 ，keystore 将 生成 为 一 个 my-release-key.jks 文件 ， 同 时 并 存 于 
所 保留 的 密 钥 其 有 效 期 为 10000 K- 


前 目录 中 ，keystone 


n 


PE Google Piay Console 
€ Allapplications 


f, Appreleases a Updated location for the Submit update and Timed publishing buttons, and your app's status 
The following changes will come into effect. 
© Android ratane appe + Status of your app will be visible in the app search field on the top-right of your app's Play Console pages. 
+ Save draft will move to a static location at the bottom of the Store listing and Pricing & distribution pages, so 


(B Artifact library that you save your draft app at any point irrespective of where you are on these pages. 


Z] Device catalog 0 
RH "uem c 
Ú Store listing A Fields marked with * need to be filled before publishing. 
@ conten rating ry E. 

English (United States) ~ en-US Messenger 
® Pricing & distribution A 9/50 
E in-app products 2 
JA Translation service Short description * 

English (United States) — en-US 
EB Services & APIs m1 
Q Optimization tips o 


SAVE DRAFT 


图 8.6 创建 新 的 应 用 程序 


在 生成 了 私 钥 后 ， 接 下 来 将 配置 Gradle 并 签署 APK。 打 开 build.gradle 模块 文件 ， 并 
在 android 全 代码 块 中 添加 signingConfigs 人 代码 块 , 其 中 包含 了 storeFile、 storePassword、 
keyAlias 和 keyPassword 项 。 在 操作 完成 后 ， 可 将 该 对 象 传递 至 应 用 程序 发 布 类 型 的 
signingConfig 属性 中 。 考 察 下 列 示例 : 


android ( 
compileSdkVersion 26 
buildToolsVersion "26.0.2" 
defaultConfig { 
applicationId "com.example.messenger" 
minSdkVersion 16 
targetSdkVersion 26 
versionCode 1 
versionName "1.0" 
testInstrumentationRunner 
"android.support.test.runner.AndroidJUnitRunner" 
vectorDrawables.useSupportLibrary = true 
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signingConfigs { 
release { 
storeFile file("../my-release-key. jks") 
storePassword "password" 
keyAlias "my-alias" 
keyPassword "password" 
) 
) 
buildTypes { 
release { 
minifyEnabled false 
proguardFiles getDefaultProguardFile('proguard-android.txt'), 
'proguard-rules.pro' 
signingConfig signingConfigs.release 
) 
) 
) 


在 执行 了 上 述 操作 后 , 即 可 签署 APK。 在 此 之 前 , 还 需要 调整 包 名 。 这 里 , 已 被 Google 
所 限 用 ， 因 而 在 将 应 用 程序 发 布 至 Play Store 之 前 应 对 包 名 进行 修改 。 在 Android Studio 
中 修改 应 用 程序 根 包 名 十 分 简单 。 首 先 ,确保 已 经 设置 了 Android Studio 并 可 显示 目录 结 
构 。 对 此 ， 可 单 击 IDE 窗口 左上 方 的 下 拉 菜 单 ， 并 设置 Project， 如 图 8.7 所 示 。 


E 
[3 
a 
= 
~ 


图 8.7 显示 目录 结构 
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完成 上 述 操作 后 , 通过 取消 选择 项 目 结构 设置 菜单 中 的 Hide Empty Middle Packages; 
可 显示 项 目 结构 视图 中 的 全 部 空中 间 包 ， 如 图 8.8 所 示 。 


3 
= 
E 
a 
E 
E 


V Hide Empty Middle Packages 


图 8.8 显示 项 目 结构 视图 中 的 全 部 空中 间 包 


在 取消 选择 上 述 选项 后 ,空中 间 包 将 不 再 处 于 隐藏 状态 ,因此 ,com.example.messenger 
分 为 3 个 可 见 包 ， 即 com. example 和 messenger。 下 面 将 example 重 命名 为 其 他 名 称 。 
对 此 ， 可 将 example 修改 为 姓 和 名 的 组 合 。 例 如 ， 对 于 Kevin Fakande 这 一 姓名 ， 包 名 将 
从 example 重 命 名 为 kevinfakande。 在 包 上 单 击 鼠 标 右键 ， 在 弹出 的 快捷 菜单 中 选择 
Refactor | Rename 命令 ， 即 可 对 其 执行 重 命名 操作 。 在 包 名 修改 完毕 后 ， 检 查 清 单 文件 和 
build.gradle 文件 ， 以 体现 项 目 包 名 的 变化 结果 。 因 此 ， 若 在 build.gradle 或 清单 文件 中 看 
到 com.example.messenger 字符 串 ， 可 将 其 修改 为 com. {full_name}.messenger. 

在 经 过 上 述 修改 后 ， 即 可 签署 对 应 的 应 用 程序 。 在 Android Studio 中 输入 下 列 命令 : 


./gradlew assembleRelease 


运行 上 述 命令 将 生成 发 布 版 本 的 APK, JFF H <project name»/«module name> 
build/outputs/apk/release 路 径 中 的 私 钥 进 行 签署 。 鉴 于 当前 项 目 中 的 模块 命名 为 app， 因 
而 APK 将 命名 为 app-release.apk。 基 于 私 钥 签署 的 APK 可 供 发 布 使 用 。 在 APK 签署 完 
毕 后 ， 下 面 将 完成 Messenger 应 用 程序 的 发 布 过 程 。 
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8.2.16 2% Android 应 用 程序 


当 Messenger 应 用 程序 签署 完毕 后 , 可 以 继续 完成 所 需 的 应 用 程序 细节 ， 以 实现 发 布 
应 用 程序 这 一 目标 。 首 先 ， 需 要 针对 当前 应 用 程序 创建 相应 的 存储 列表 。 相 应 地 ， 打 开 
Google Play Console 中 的 Messenger 应 用 程序 ， 并 移 至 存储 列表 页 (可 选取 导航 栏 上 的 
Store Listing) 。 

在 执行 后 续 操 作 之 前 ， 此 处 需要 填写 列表 中 的 全 部 信息 ， 相 关 信息 包括 标题 、 简 短 
描述 、 完 整 描 述 、 图 像 数据 资源 以 及 分 类 信息 〈 包 括 应 用 程序 类 型 、 类 别 和 内 容 评级 、 
联系 方式 以 及 隐私 策略 ) 。 图 8.9 显示 了 Google Play Console 存储 列表 页 面 。 


PB Googie Play consoe 三 Store listing 


€ All applications ENGLISH (UNITED STATES) 


M. Appreleases A pleose check out our Impersonation and intellectual Property policy to avoid common violations. 
© Android Instant Apps 
PHONE TABLET  ANORODTV ANDROID WEAR 
国 Aritact ibrary = 
J] Device catalog o ee 


App signing 


Store listing 


3/8 screenshots BROWSE FILES 


Pricing & distribution 


ov 
a 
@ content ating 
[7 
B 


In-app products Hi-res eon * Feature Graphic * Promo Graphic. 
Default ~ English (United States) ~ en-US  Default- English (United States) ~ en-US Defaut ~ English (United States) ~ en-US 
Ba Translation service 512x512 1024wx500h 180wx120h 
32-bit PNG (with aipha) JPG or 24-bit PNG (no aipha) JPG or 24-bit PNG (no alpha) 


E services apis 


Q optimization tips o 


SAVE DRAFT 


图 8.9 Google Play Console 存储 列表 页 面 


当 存 储 列表 信息 填写 完毕 后 ， 接 下 来 需要 完善 价格 和 分 发 信息 。 对 此 ， 可 选取 左 侧 
导航 栏 的 Pricing & distribution 选项 ， 并 打开 偏好 设置 项 。 出 于 显示 目的 ， 此 处 可 将 当前 
App 的 价格 设置 为 FREE。 除 此 之 外 , 还 需要 选取 5 个 随机 国家 以 分 发 该 App, BI Nigeria, 
India、the United States of America、the United Kingdom 和 Australia， 如 图 8.10 所 示 。 

除了 选取 价格 类 型 和 产品 分 发 的 国家 之 外 ， 还 需要 提供 额外 的 偏好 设置 信息 ， 包 括 
设备 类 别 信息 、 用 户 程 序 信息 以 及 知情 信息 。 

下 面向 Google Play Console 应 用 程序 中 添加 签署 后 的 APK。 对 此 ， 可 访问 App 
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releases | MANAGE BETA | EDIT RELEASE. 在 对 应 的 显示 页 面 中 , 读者 将 被 提示 是 否 ; 
择 Google Play 应 用 程序 签署 操作 ， 如 图 8.11 所 示 。 


€ All applications 
hop releases. A @ 


© Android instant Apps Designed for GooglePlay Managed Daydream Android Wear Android TV — Android Auto 
Families for Education Googte Play 
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B Servicos sapie + restof wo production 


Q optimization tps. o 


SAVE DRAFT 
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€ Allapplications Manage your apps APKS, review release history, and rollout your app to production, alpha, or beta. Learn more 
MÀ Appreleases. A © Newrelease to beta 
© Android instant Apps o o 
Prepare release ew and rollout 

(B Artifact library = 
E] Device catalog @ Goode Play App Signing 

Google Play App Signing secures your app using Google's robust security infrastructure. Learn more 
Ov App signing Clicking Continue wil permanently enrol your app into Google Play App Signing 
É Store isting " connue onn REUSE SIGNING KEY 
© Content rating 

APKS to add 
@ Pricing & distribution 
E in-app products 
FA Translation service Drop your APK fle here, or select a fle 
$B services & apts 
Q Optimization ips. o 


图 8.11 是 否 选择 Google Play 应 用 程序 签署 操作 
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出 于 演示 目的 ， 此 处 可 选取 OPT-OUT。 当 选择 OPT-OUT 之 后 ， 即 可 选取 从 计算 机 文 
件 系统 中 上 传 的 APK 文件 。 单 击 BROWSE FILES 按钮 ， 选 择 所 上 传 的 APK， 如 图 8.12 
所 示 。 


€ New release to beta 


Prepare release. Review and rollout 


APKs to add 


ADD APK FROM LIBRARY 
These APKs will be served in the Google Play Store after the rollout of this release. 5—€—— 


Drop your APK file here, or select a file. 


BROWSE FILES 


Release name 


Name to identify release in the Play Console only, such as an internal code name or build version. 


Enter a release name 


0/50 
Suggested name is based on version name of first APK added to this release. 


图 8.12 上 传 APK 文件 


在 选取 了 相应 的 APK 文件 后 , 可 将 其 上 传 至 Google Play Console rf. 待 上 传 完 毕 后 ， 
Google Play Console 将 针对 Beat 版 本 自动 添加 所 建议 的 发 布 名 称 , 该 名 称 基于 上 传 的 APK 
版 本 名 。 当 然 ， 读 者 也 可 自行 更 改版 本 名 称 。 随 后 ， 可 在 文本 框 中 填写 相应 的 版 本 注释 。 
在 相关 数据 得 以 完善 后 ， 可 单 击 页 面 下 方 的 Review 按钮 ， 保 存 并 执行 后 续 操 作 。 在 Beta 
版 本 审查 完毕 后 ， 还 可 向 App 中 加 入 Beta 测试 人 员 人 信息。 下面 返回 至 我 们 所 讨论 的 重点 
内 容 Messenger 应 用 程序 的 发 布 。 

当 应 用 程序 APK 上 传 完 毕 后 ， 即 可 着 手 展 开 内 容 评 级 操作 。 对 此 ， 单 击 侧 栏 上 的 
Content rating 导航 选项 ， 并 遵循 相关 操作 指令 。 当 填写 相关 调查 内 容 后 ， 即 可 生成 相应 
的 应 用 程序 评级 结果 ， 如 图 8.13 所 示 。 

一 旦 完成 内 容 评级 调查 , 应 用 程序 即 可 发 布 为 最 终 产品 , 并 对 Google Play Store 上 的 
所 有 用 户 可 见 。 在 Google Play Console 上 , 可 访问 App releases | Manage Production | Create 
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releases 予以 查看 。 当 提示 生成 APK 时 ， 单 击 屏 幕 右 侧 的 ADD APK FROM LIBRARY 按 
钮 ， 并 选取 之 前 上 传 的 APK (包含 版 本 号 1.0 的 APK 文件 ) ， 并 完成 必要 的 发 布 信息 。 
单 击 REVIEW 按钮 完成 后 续 操作 ， 此 时 可 以 看 到 如 图 8.14 所 示 的 简要 的 发 布 摘要 。 
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图 8.14 简要 的 发 布 摘要 
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读者 应 仔细 阅读 其 中 的 信息 。 随 后 即 进入 产品 阶段 。 此 时 , 读者 将 被 提示 : 当前 App 
将 发 布 Play Store 中 ， 以 供 广 大 用 户 所 用 ， 如 图 8.15 所 示 。 


Your app will now become available to all users of the Play Store. Do you wart to continue? 


CANCEL CONFIRM 


图 8.15 发布 至 Play Store 
单 击 CONFIRM 按钮 后 ，Messenger 应 用 程序 即 发 布 至 Google Play Store 中 。 


83 本 章 小 结 


章 讨论 了 Android 应 用 程序 框架 ， 其 中 涉及 了 Android 应 用 程序 的 安全 性 以 及 
Google Play Store HRAM. HEPER T Android 应 用 程序 所 面临 的 安全 威胁 ， 并 详细 
介绍 了 缓解 此 类 威胁 的 相关 方法 , 还 指出 了 Android 生态 系统 开发 应 用 程序 时 需要 遵循 的 
最 佳 实践 案例 。 除 此 之 外 ， 本 章 还 学 习 了 如 何 使 用 存储 媒介 安全 地 执行 网 络 操作 过 程 。 
另外 ， 我 们 还 学 习 了 如 何 保护 Android 组 件 ， 如 服务 和 广播 接收 器 。 

最 后 , 本 章 还 深入 研究 了 Play Store 应 用 程序 的 发 布 过 程 ,除了 介绍 成 功 发 布 Android 
应 用 程序 所 需 的 各 项 步骤 之 外 ,我 们 还 进一步 将 之 前 的 Messenger 应 用 程序 发 布 到 Google 
Play Store 中 。 

第 9 章 将 继续 介绍 KotlinWeb 应 用 程序 开发 ， 并 着 手 开发 一 个 定位 查看 应 用 程序 。 
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本 书 前 4 章 讨 论 了 Android 平台 上 应 用 程序 开发 中 Kotlin 语言 的 应 用 。 第 8 章 则 详 
细 介 绍 了 Android 应 用 程序 安全 和 部 署 方面 的 问题 。 另外, 当 与 数据 存储 协同 工作 以 及 实 
现 网 络 通信 时 ， 还 展示 了 与 安全 相关 的 最 佳 实践 方案 。 当 处 理 用 户 输入 和 用 户 证 书 时 ， 
我 们 还 考察 了 相关 的 安全 措施 。 

进一步 讲 , 第 8 章 Android 应 用 程序 组 件 安全 方面 的 各 种 方案 , 例如 服务 和 广播 接收 
器 。 最 后 ,还 逐步 讲解 了 如 何 向 Google Play Store 中 部 署 应 用 程序 。 本 章 将 深入 讨论 基于 
Web 的 Kotlin 解决 方案 ， 特 别 是 如 何 使 用 Spring 开发 一 款 Place Reviewer 应 用 程序 ， 并 
主要 集中 于 前 端 开发 。 本 章 主要 涉及 以 下 内 容 : 
Q ”模型 -视图 -控制 器 设计 模式 。 
O Logstash 及 其 在 数据 集中 化 、 数 据 转换 以 及 数据 存储 方面 的 应 用 。 
Q ”基于 Spring Security 的 网 站 安全 问题 。 


91 MVC 设计 模式 


MVC 模式 也 称 作 模型 -视图 -控制 器 模式 , 主要 用 于 应 用 程序 中 内 容 的 分 离 。 特 别 地 ， 
这 种 用 户 接 口 设计 模式 将 应 用 程序 分 为 3 个 独立 的 组 件 ， 将 应 用 程序 模块 划分 为 多 个 独 
立 部 分 包含 多 种 原因 。 其 中 之 一 是 将 显示 逻辑 从 核心 业务 逻辑 中 分 离 出 来 。 下 面 考察 
MVC 模式 中 这 3 类 应 用 组 件 。 


9.1.1 模型 


模型 主要 负责 数据 管理 以 及 MVC 应 用 逻辑 。 由 于 模型 视 为 全 部 数据 和 业务 逻辑 的 管 
理 者 ， 因 而 可 认为 是 MVC 应 用 程序 的 动力 源泉 。 


9.1.2 视图 


视图 表示 为 数据 的 视觉 表达 ， 并 通过 应 用 程序 生成 ， 同时， 这 也 是 用 户 与 应 用 程序 
的 主要 交互 点 。 
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9.1.3 ”控制 器 


控制 器 是 视图 和 模型 之 间 的 中 介 体 ， 主 要 负责 从 视图 中 获取 输入 ， 并 将 输入 数据 的 适 
当 转 换 形 式 传递 至 模型 中 。 除 此 之 外 ， 必 要 时 ， 控 制 器 还 将 通过 数据 更 新 视图 ， 如 图 9.1 
所 示 。 


用 户 活动 发 送 输入 内 容 
更 新 视图 通知 


图 9.1 MVC 设计 模式 


92 设计 并 实现 Place Reviewer 后 台 程 序 


本 章 将 对 系统 市 场 制定 多 个 用 例 规范 ， 针 对 系统 数据 库 实现 标识 所 需 的 实体 ， 并 深 
考察 系统 的 开发 过 程 。 下 面 首先 讨论 Place Reviewer 系统 的 用 例 。 


9.2.1 用 例 标 识 


本 节 首 先 标识 系统 中 的 actor。 在 此 之 前 ， 我 们 需要 整体 理解 Place Reviewer 应 用 程 
序 的 功能 。 
一 如 读者 所 了 解 到 的 ，Place Reviewer 应 用 程序 是 一 种 基于 互联 网 的 应 用 程序 ， 并 支 
持平 台 用 户 的 评论 功能 。 其 中 ， 注 册 用 户 可 借助 于 地 图 ， 并 对 相关 地 点 发 表 评论 。 
在 了 解 了 Place Reviewer 应 用 程序 的 功能 后 ， 下 面 将 确定 Place Reviewer 应 用 程序 的 
actor。 相 信 读 者 已 经 猜 到 ，Place Reviewer 应 用 程序 目前 仅 包含 单一 actor， 即 用 户 。 用 户 
的 用 例 包 含 以 下 内 容 : 
日 户 利用 Place Reviewer 发 表 评 论 。 
日 户 通 过 Place Reviewer 应 用 程序 查看 其 他 用 户 的 评论 。 
有 户 可 在 交互 式 地 图 上 查看 其 他 用 户 评 论 的 地 点 。 
HF n fitit Place Reviewer 平台 。 


H 
H 
H 
H 


Oooo 
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口 用 户 可 注销 Place Reviewer 账号 。 
截至 目前 ， 前 述 内 容 讨 论 了 Place Reviewer 系统 的 功能 ， 标 识 了 系统 的 actor， 并 通 
过 唯一 的 actor 一 一 用 户 一 一 标识 了 系统 的 用 例 。 下 面 将 标识 系统 中 所 需 的 数据 。 


9.2.2 ”标识 数据 


作为 上 述 用 例 定义 的 结果 , 可 通过 创建 相应 的 模型 , 方便 地 标识 Place Reviewer 应 用 
程序 所 需 的 数据 类 型 。 其 中 ， 第 一 种 数据 类 型 为 用 户 数 据 ， 第 二 种 类 型 则 是 评论 数据 。 
顾名思义 ， 用 户 数据 表示 与 平台 注册 用 户 相 关 的 数据 ， 而 评论 数据 则 是 针对 平台 中 生成 
的 评论 所 需 的 数据 。 

用 户 需 要 使 用 到 以 下 数据 : 用 户 的 电子 邮件 地 址 、 用 户 名 、 密 码 和 账号 状态 。 除 此 
之 外 ， 还 需要 针对 每 个 平台 用 户 使 用 唯一 的 标识 符 ， 即 用 户 DD， 以 及 用 户 的 注册 日 期 。 
对 于 评论 对 应 的 数据 ， 需 要 使 用 到 评论 标题 、 评 论 内 容 、 评 论 地 址 、 地 名 、 额 外 的 一 些 
信息 〈 例 如 经 纬度 坐标 ) 以 及 标定 地 址 的 地 名 ID。 除 此 之 外 ， 还 需要 使 用 到 评论 的 唯一 
标识 符 ， 以 及 与 评论 时 间 相 关 的 信息 。 

此 处 ， 读 者 可 能 会 产生 疑问 : 为 何 需 要 使 用 到 与 地 名 (具体 地 址 以 及 经 纬度 ) 外 加 
评论 相关 的 信息 ?为 何不 分 离 出 此 类 信息 ， 并 将 其 视 为 独立 的 类 型 ? 这 种 思考 方式 是 存 
在 一 定 道理 的 ， 进 而 可 据 此 定义 一 个 数据 库 表 ， 并 包含 与 评论 相关 的 地 名 信息 。 然 而 ， 
当前 暂 未 定义 这 一 类 表 项 。 

接 下 来 的 问题 是 ， 如 何 使 用 户 能 够 查看 未 包含 任何 信息 的 地 址 ? 答案 十 分 简单 : 对 
此 ， 可 使 用 Google 提供 的 Places API， 第 10 章 将 对 此 加 以 讨论 ， 当 前 主要 关注 Place 
Reviewer 后 台 程 序 的 实现 过 程 。 


9.2.3 设置 数据 库 


考虑 到 系统 信息 存储 的 必要 性 ， 我 们 需要 针对 当前 应 用 程序 配置 数据 库 ， 以 实现 数 
据 的 持久 化 。 前 述 应 用 程序 利用 Postgres 作为 数据 库 ， 此 处 也 将 继续 沿袭 这 一 方式 。 打 
开 Terminal 并 运行 下 列 命令 : 


createdb -h localhost —username=<username> place-reviewer 


当 预 习 上 述 命令 时 ， 系 统 中 将 创建 名 为 place-reviewer 的 数据 库 。 这 里 ， 所 输入 的 、 
用 以 替代 <username> 参 数 的 用 户 名 将 作为 连接 数据 库 的 用 户 名 。 针 对 当前 应 用 程序 配置 
了 数据 库 后 ， 即 可 着 手 开始 实现 后 台 程序 ， 此 处 将 采用 Spring 框架 。 
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9.24 实现 后 台 应 用 程序 


在 定义 了 应 用 程序 用 例 ， 并 配置 了 应 用 程序 所 连接 的 数据 库 后 ， 下 面 直接 进入 实现 
过 程 ,打开 IntelliJ IDEA 并 利用 Spring 初始 化 器 创建 新 的 项 目 。 在 单 击 Next 按 钮 后 , IntelliJ 
将 检索 Spring 初始 化 器 ， 随 后 用 户 将 被 提示 提供 与 应 用 程序 相关 的 特定 信息 。 在 完成 后 
续 步 骤 之 前 ， 需 要 执行 下 列 操 作 : 

(1) 输入 com.example 作为 项 目 组 织 ID. 

(2) 输入 place-reviewer 作为 项 目 ID。 

(3) 选择 Maven Project 作为 项 目 类 型 〈 若 未 选取 ) 。 

(4) 保留 包 选 项 以 及 Java 版 本 。 

C5) 选择 Kotlin 作为 当前 语言 。 鉴 于 后 续 操作 将 使 用 Kotlin 语言 ， 因 而 该 步 又 十 分 


要 


limi 
MEN 


(6) 将 版 本 属性 修改 为 1.0.0。 
(7) 输入 选择 描述 ， 此 处 为 Ours is A nifty web application for the creation of location 
reviews. 
(8) 输入 com.example.placereviewer 作为 包 名 。 
在 完善 了 所 需 的 项 目 信 息 后 ， 可 单 击 Next 按钮 执行 后 续 操作 。 在 接 下 来 的 画面 中 ， 
需要 些 当前 项 目的 依赖 关系 。 


Oz. 

Spring 初始 化 器 与 Spring 插件 一 起 出 现 。 在 本 书 编写 时 ， 仅 IntelliJ IDEA 旗舰 版 本 
对 此 予以 支持 ， 且 需要 提供 付费 证 书 。 如 果 读 者 安装 了 IntelliJ IDEA 共享 版 ， 可 简单 地 
使 用 Spring 初始 化 器 工具 ( 对 应 网 址 为 https://start.spring.io ) 生成 当前 项 目 ， 并 将 该 项 目 
导入 IntelliJIDEA 中 。 


随后 可 选择 Spring 中 的 Security. Session, Cache 和 Web 依赖 关系 。 除 此 之 外 ， 还 
需要 在 template engine 分 类 项 中 选择 Thymeleaf。 在 SQL 分 类 项 下 方 ， 选 取 PostgreSQL。 
此 外 ， 在 屏幕 上 方 的 Spring Boot Version 下 拉 菜 单 中 ， 选 择 2.0.0 M7 作为 版 本 号 。 在 依 
赖 关系 选 择 完毕 后 ， 最 终结 果 如 图 9.2 所 示 。 

在 指定 了 相应 的 依赖 关系 后 ， 单 击 Next 按钮 执行 后 续 的 配置 操作 。 此 时 需要 提供 项 
目 名 称 和 项 目的 保存 位 置 。 相 应 地 ， 可 填写 place-reviewer 作为 项 目 名 称 ， 并 选择 项 目的 
保存 位 置 ， 如 图 9.3 所 示 。 
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New Project 


图 9.2 选取 依赖 关系 项 


图 9.3 项 目 名 称 和 项 目的 保存 位 置 
随后 ， 可 单 击 Finish 按钮 ， 并 等 待 项 目 配置 完毕 。 接 下 来 将 显示 包含 初始 化 项 目 文 


件 的 新 窗口 。 鉴 于 之 前 已 经 输入 了 Spring 项 目 结构 简 述 ， 此 处 无 须 重 复 操作 。 在 进入 下 
一 阶段 之 前 ， 还 需要 向 当前 项 目的 pom 文件 中 添加 下 列 依赖 关系 。 


<dependency> 


<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-data-jpa</artifactId> 
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</dependency> 

<dependency> 
<groupId>org.webjars</groupId> 
<artifactId>bootstrap</artifactId> 
<version>4.0.0-beta.3</version> 

</dependency> 

<dependency> 
<groupId>org.webjars</groupId> 
<artifactId>jquery</artifactId> 
<version>3.2.1</version> 

</dependency> 


下 面 将 当前 应 用 程序 连接 至 数据 库 中 。 
9.2.5 将 后 台 程 序 连 接 至 Postgres 


在 将 Place Reviewer 后 台 应 用 程序 连接 至 PostgresQL 数据 库 时 ， 需 要 修改 项 目的 
application.properties 文件 ， 并 添加 连接 PostgreSQL 数据 库 所 需 的 相关 属性 。 打 开 项 目的 
application.properties 文件 ， 并 添加 下 列 属性 : 

spring.jpa.hibernate.ddl-auto-create-drop 

spring.jpa.generate-ddl-true 

Spring.datasource.url-jdbc:postgresql://localhost:5432/ 

place-reviewer 


spring.datasource.driver.class-name-org.postgresql.Driver 
spring.datasource.username-«username» 


插入 相应 的 用 户 名 ， 其 中 ，<username> 属 性 位 于 上 述 代码 片段 中 ， 在 添加 了 数据 库 
连接 属性 后 ，Spring Boot 将 在 应 用 程序 启动 时 ， 将 其 连接 至 所 指定 的 数据 库 。 在 项 目的 
数据 库 连 接 属性 设置 完毕 后 ， 下 面 针对 之 前 标识 的 User 和 Review 实体 构建 对 应 的 模型 。 


9.26 ”创建 模型 


前 述 内 容 标识 了 系统 所 需 的 两 种 实体 类 型 ， 即 User 实体 和 Review 实体 。 下 面 针 对 
此 类 实体 生成 相应 的 模型 。 首 先 考 察 User 实体 。 对 此 ， 可 在 com.example.placereviewer 
包 中 生成 data 包 , 并 在 新 创建 的 data 包 中 添加 model 包 。 随后 , 在 新 创建 的 com.example. 
placereviewer.data.model 包 中 添加 User.kt 文件 ， 并 加 入 以 下 内 容 : 


package com.example.placereviewer.data.model 


import com.example.placereviewer.listener.UserListener 
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import org.springframework.format.annotation.DateTimeFormat 
import java.time.Instant 
import java.util.* 
import javax.persistence.* 
import javax.validation.constraints.Pattern 
import javax.validation.constraints.Size 
@Entity 
@Table (name = "`user`") 

@EntityListeners (UserListener::class) 

data class User( 

@Column (unique = true) 

@Size(min = 2) 

@Pattern(regexp = "^[A-Z0-9. %+-]+@[A-Z0-9.-]+\\\\.[A-Z] {2,6}\$") 


var email: String = "", 
@Column (unique = true) 


var username: String = "", 

@Size(min = 60, max = 60) 
var password: String = "", 

@Column (name = "account status") 

@Pattern(regexp = "\\A(activated|deactivated) \\z") 
var accountStatus: String = "activated", 

@Id 


@GeneratedValue (strategy = GenerationType.AUTO) 
var id: Long = 0, 

@DateTimeFormat 

@Column (name = "created at") 
var createdAt: Date = Date.from(Instant.now()) 


) 3i 


@OneToMany (mappedBy = "reviewer", targetEntity = Review::class) 


private var reviews: Collection<Review>? = null 


) 


根据 之 前 Spring 中 实体 的 操作 经 验 ， 上 述 代 码 无 须 做 过 多 解释 ， 其 中 定义 了 包含 
email, username, password. accountStatus, id 以 及 createdAt 属性 的 User 实体 。 除 此 之 
dh, User 中 还 包含 了 多 个 Review 实体 。 针 对 包含 @EntityListener 注解 的 实体 ， 我 们 还 对 
其 设置 了 实体 监听 器 。 对 此 ， 将 新 的 listener 包 添 加 至 com.example.placereviewer 中 ， 并 
将 UserListener.kt 文件 加 入 其 中 ， 对 应 代码 如 下 所 示 : 


package com.example.placereviewer.listener 


import com.example.placereviewer.data.model.User 
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import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder 
import javax.persistence.PrePersist 
import javax.persistence.PreUpdate 


class UserListener ( 


@PrePersist 
@PreUpdate 
fun hashPassword(user: User) { 
user.password = BCryptPasswordEncoder () .encode (user.password) 


} 


UserListener 中 定义 了 单一 的 hashPassword 函数 ， 该 函数 在 User 实体 持久 化 和 更 新 
之 前 被 调用 ， 其 唯一 工作 是 在 数据 库 持 久 化 之 前 ， 将 password 编码 为 密 文 。 

在 针对 User 实体 创建 了 相应 的 监听 器 后 ， 下 面 考察 Review 实体 。 在 com.example. 
placereviewer.data.models 中 设置 Review.kt 文件 ， 并 添加 下 列 代码 : 


package com.example.placereviewer.data.model 


import org.springframework.format.annotation.DateTimeFormat 
import java.time.Instant 

import java.util.* 

import javax.persistence.* 

import javax.validation.constraints.Size 


GEntity 
@Table (name = "'review'") 
data class Review( 
@ManyToOne (optional = false) 
@JoinColumn(name = "user id", referencedColumnName = "id") 
var reviewer: User? = null, 
@Size(min = 5) 


Var title: String =)", 
@Size(min = 10) 

var body: String = "", 
@Column (name = "place address") 
@Size(min = 2) 

var placeAddress: String = "", 


@Column (name 


"place name") 


"n 
, 


var placeName: String 


@Column (name 


"place id") 
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var placeId: String = "", 
var latitude: Double - 0.0, 
var longitude: Double - 0.0, 
era 
@GeneratedValue (strategy = GenerationType.AUTO) 
var id: Long - 0, 
@DateTimeFormat 
@Column (name = "created at") 
var createdAt: Date = Date.from(Instant.now()) 


) 


其 中 定义 了 Review 类 ,并 包含 reviewer. title, body. placeAddress , placeName, placeId, 
latitude, longitude, id 和 createdAt 属性 。 其 中 ，reviewer 属性 表示 为 User 类 型 ， 并 引用 
了 review 的 生成 器 一 一 每 条 评论 由 用 户 生成 。 另 外 ,一 位 用 户 可 生成 多 条 评论 。 相 应 地 ， 
可 利用 @ManyToOne 注解 声明 Review 和 User 实体 之 间 的 关系 。 


9.2.7 ”创建 数据 存储 库 


前 述 内 容 设 置 了 所 需 的 实体 ， 因 而 还 应 构建 与 实体 数据 访问 相关 的 存储 库 。 对 此 ， 
可 在 com.example.placereviewer 包 中 创建 存储 库 包 。 鉴 于 当前 包含 两 种 实体 ,因而 须 创建 
两 个 存储 库 〈 其 中 之 一 用 于 访问 与 每 个 实体 相关 的 数据 ) ， 分 别 为 UserRepository 和 
ReviewRepository 。 随后 ， 可 在 com.example.placereviewer.data.repository 中 定义 
UserRepository 接口 ， 如 下 所 示 : 

package com.example.placereviewer.data.repository 


import com.example.placereviewer.data.model.User 
import org.springframework.data.repository.CrudRepository 


interface UserRepository : CrudRepository«User, Long» { 


fun findByUsername (username: String): User? 


} 


findByUsemame(String) 方 法 从 数据 库 中 检索 User， 其 中 包含 了 作为 参数 传递 至 该 方 
法 中 的 用 户 名 。ReviewRepository 接口 定义 如 下 : 


package com.example.placereviewer.data.repository 


import com.example.placereviewer.data.model.Review 
import org.springframework.data.repository.CrudRepository 
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interface ReviewRepository : CrudRepository<Review, Long> { 


fun findByPlaceId(placeId: String) 
) 


在 设置 了 查询 实体 的 实体 以 及 存储 库 后 ， 即 可 以 服务 和 服务 实现 的 方式 完成 Place 
Reviewer 应 用 程序 的 核心 业务 逻辑 。 


9.2.8 Place Reviewer 业务 逻辑 实现 


如 前 所 述 ,在 基于 MVC 设计 模式 的 应 用 程序 中 ,存在 3 种 主要 的 组 件 ， 即 模型 、 视 
图 和 控制 器 。 相 应 地 ， 模 型 组 件 负 责 数据 管理 和 业务 逻辑 的 执行 。 在 Place Reviewer 应 用 
程序 中 ， 模 型 将 以 服务 的 形式 实现 模型 ， 并 用 于 后 台 程 序 中 。 对 此 ， 可 创建 两 个 基本 的 
服务 ， 分 别 用 于 管理 与 应 用 程序 用 户 相关 的 数据 以 及 评论 数据 。 

首先 ， 需 要 定义 UserService 接口 ， 其 中 定义 了 UserServiceImpl 类 需要 实现 的 各 种 行 
为 。 之 前 在 Place Reviewer 应 用 程序 用 例 中 曾 谈 到 , 用户 需要 在 平台 上 进行 注册 (因而 需 
要 创建 账户 ) 。 因 此 ， 当 前 模型 中 须 对 此 予以 处 理 。 相 应 地 ， 可 在 项 目的 根 数据 包 中 创 
££ service 包 ， 并 将 UserService 接口 添加 于 其 中 ， 如 下 所 示 : 


package com.example.placereviewer.service 


interface UserService { 


fun register (username: String, email: String, password: String): Boolean 

} 

其 中 仅 声明 了 一 个 方法 ， 且 需要 通过 有 效 的 UserService HARI. register (String, 
String, String) 方 法 接收 3 个 参数 : 第 一 个 参数 表示 为 注册 用 户 的 用 户 名 ; 第 二 个 参数 表示 
用 户 有 效 的 电子 邮件 地 址 ;第 三 个 参数 表示 为 密码 。 当 利用 相应 的 参数 调用 register0 方 
法 时 ， 该 方法 将 通过 用 户 提供 的 证 书 注册 用 户 。 如 果 用 户 注册 成 功 ， 则 该 方法 返回 true, 
否则 返回 false。 

下 列 代 码 表示 为 UserService 实现 ， 可 将 其 添加 至 service 包 中 。 


package com.example.placereviewer.service 


import com.example.placereviewer.data.model.User 
import com.example.placereviewer.data.repository.UserRepository 
import org.springframework.stereotype.Service 
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GService 
class UserServicelImpl(val userRepository: UserRepository) 


UserService { 


override fun register(username: String, email: String, 
password: String): Boolean ( 
val user - User(email, username, password) 
userRepository.save (user) 


return true 
} 
} 


UserServicelmpl 类 实现 的 register0 其 工作 机 制 较为 直观 。 当 传递 了 有 效 的 用 户 名 、 
电子 邮件 地 址 以 及 密码 参数 后 ， 将 生成 一 个 新 的 用 户 对 象 ， 同 时 向 其 构造 函数 传递 相关 
参数 。 在 用 户 对 象 创建 完毕 后 ， 该 用 户 将 通过 下 列 代码 保存 至 数据 库 中 。 

userRepository.save (user) 

userRepository 表示 为 之 前 生成 的 UserRepository 实例 ， 该 实例 通过 Spring 框架 自动 
ELA UserServiceImpl 的 构造 函数 中 。 当 用 户 保 存 至 数据 库 后 ， 将 返回 true. 

下 面 实现 评论 服务 接口 ， 其 中 涉及 平台 用 户 生成 的 评论 和 评论 列表 。 最 终 ， 用 户 服 
务 接口 中 需要 实现 createReviewO 和 listReview() 方 法 。 

下 面向 当前 项 目的 service 包 中 添加 ReviewService 接口 ， 如 下 所 示 : 


package com.example.placereviewer.service 
import com.example.placereviewer.data.model.Review 
interface ReviewService { 
fun createReview(reviewerUsername: String, reviewData: Review): Boolean 


fun listReviews(): Iterable<Review> 
) 
针对 我 们 所 创建 的 服务 ， 下 列 代码 定义 了 ReviewServiceImpl 类 ， 将 该 类 连同 后 续 章 
节 创 建 的 全 部 服务 添加 至 com.example.placereviewer.service 中 ， 如 下 所 示 : 
package com.example.placereviewer.service 


import com.example.placereviewer.data.model.Review 
import com.example.placereviewer.data.model.User 
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import com.example.placereviewer.data.repository.ReviewRepository 
import com.example.placereviewer.data.repository.UserRepository 
import org.springframework.stereotype.Service 


@Service 
class ReviewServiceImpl (val reviewRepository: ReviewRepository, val 
userRepository: UserRepository) : ReviewService { 


override fun listReviews(): Iterable<Review> { 
return reviewRepository.findAll() 


} 


override fun createReview (reviewerUsername: String, 
reviewData: Review): Boolean { 
val reviewer: User? = userRepository.findByUsername (reviewerUsername) 


if (reviewer !- null) ( 
reviewData.reviewer - reviewer 
reviewRepository.save (reviewData) 
return true 


} 


return false 
} 

} 

listReviewsO 返 回 包含 存储 于 应 用 程序 数据 库 中 的 、 全 部 评论 的 Iterable. 另外 一 方面 ， 
createReviewO 接 收 一 个 字符 串 ， 其 值 表示 为 评论 用 户 的 用 户 名 ， 以 及 一 个 Review 实例 ， 
其 中 包含 了 所 创建 的 评论 数据 。 通 过 调用 UserRepository 的 findByUsername() 方 法 ， 
createReview0) 首 先 获 得 包含 特定 用 户 名 的 用 户 ， 对 应 的 用 户 即 为 发 表 评 论 的 用 户 。 

如 果 UserRepository 返回 一 个 非 null 对 象 ， 说 明 存 在 相关 用 户 ; 同时 ， 访 用户 被 赋予 
已 保存 的 评论 中 的 reviewer 属性 中 。 在 赋值 完毕 后 ， 评 论 将 被 保存 至 数据 库 中 且 函 数 返回 
true, 表明 操作 成 功 。 如 果 为 发 现 包含 当前 用 户 名 的 用 户 , 那么 , createReview0 将 返回 false. 

在 以 服务 形式 构建 了 相关 模型 后 ,下面 考察 Place Reviewer 的 安全 问题 。 考虑 到 非 授 
权 用 户 不 可 访问 应 用 程序 资源 ， 因 而 这 一 问题 较为 重要 。 


9.2.9 Place Reviewer 后 台 应 用 程序 的 安全 问题 


与 第 4 章 讨论 的 Messenger API 安全 类 似 ， 此 处 也 将 使 用 Spring Security 处 理 Place 
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Reviewer 后 台 应 用 程序 的 安全 问题 。 除了 Spring Security 之 外 , 当前 应 用 程序 的 安全 处 理 
稍 有 不 同 。 在 第 4 章 ， 对 于 客户 端 应 用 程序 的 验证 操作 ， 我 们 配置 了 Spring Security, JF 
显 式 地 依靠 于 ISON Web 令 牌 ， 而 此 处 的 处 理 方式 仅 使 用 Spring Security， 且 不 再 涉及 
JSON Web 令 牌 。 

首先 需要 针对 应 用 程序 构建 一 个 自 定 义 Web 安全 配置 ， 并 实现 Spring 框架 的 


WebSecurityConfigurerAdapter。 在 com.example.placereviewer 中 设置 一 个 config 1, H 


H 


定 


X WebSecurityConfig 类 ， 如 下 所 示 : 


package com.example.placereviewer.config 


import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 


import 


import 


com.example.placereviewer.service.AppUserDetailsService 
org.springframework.context.annotation.Bean 
org.springframework.context.annotation.Configuration 
org.springframework.http.HttpMethod 
org.springframework.security.authentication.AuthenticationManager 
org.springframework.security.config.BeanIds 
org.springframework.security.config.annotation 
.authentication.builders.AuthenticationManagerBuilder 
org.springframework.security.config.annotation 
.web.builders.HttpSecurity 
org.springframework.security.config.annotation 
-web.configuration.EnableWebSecurity 
org.springframework.security.config.annotation 
.web.configuration.WebSecurityConfigurerAdapter 
org.springframework.security.core.userdetails 
-UserDetailsService 
org.springframework.security.crypto.bcrypt 
.BCryptPasswordEncoder 
org.springframework.security.web 
-DefaultRedirectStrategy 
org.springframework.security.web.RedirectStrategy 


GConfiguration 
GEnableWebSecurity 
class WebSecurityConfig(val userDetailsService:AppUserDetailsService): 


WebSecurityConfigurerAdapter() { 


private val redirectStrategy: RedirectStrategy 


DefaultRedirectStrategy() 
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@Throws (Exception::class) 
override fun configure(http: HttpSecurity) { 
http.authorizeRequests () 
-antMatchers (HttpMethod.GET,"/register").permitAll() 
-antMatchers (HttpMethod. POST, "/users/registrations") .permitAl] () 
-antMatchers (HttpMethod.GET, "/css/**") .permitAll() 
-antMatchers (HttpMethod.GET,"/webjars/**").permitAll() 
-anyRequest () . authenticated() 
-and() 
-formLogin() 
- loginPage ("/login") 
-successHandler { request, response, => 
redirectStrategy.sendRedirect (request, response, "/home") 

} 
.permitAll() 
-and() 
- Logout () 
.permitAll() 


@Throws (Exception::class) 
override fun configure(auth: AuthenticationManagerBuilder) { 
auth.userDetailsService«UserDetailsService» (userDetailsService) 
-passwordEncoder (BCryptPasswordEncoder ()) 


@Bean (name = [BeanIds.AUTHENTICATION MANAGER]) 
override fun authenticationManagerBean(): AuthenticationManager ( 
return super.authenticationManagerBean () 
} 
} 


如 前 所 述 , WebSecurityConfig 的 configure(HttpSecurity) 方 法 其 任务 是 配置 HTTP URL 
安全 路 径 。 利 用 configure(HttpSecurity) 方 法 ， 我 们 配置 了 Spring Security， 并 允许 所 有 用 
户 访问 /users/registrations 和 GET 请 求 (其 路 径 匹 配 于 /register、/css 和 /webjars/**) 。 除 
此 之 外 ， 我 们 还 允许 所 有 的 HTTP 请 求 可 进入 从 /login 路 径 访问 的 登录 页 面 。 

我 们 向 登录 动作 中 成 功 地 添加 了 一 个 处 理 程 序 ， 并 使 用 了 WebSecurityConfig 类 定义 
的 redirectStrategy 属性 ;， 当 用 户 成 功 登 录 后 ， 可 将 客户 端 重 定向 至 /home。 最 后 ， 我 们 还 
应 支持 后 端 应 用 程序 的 全 部 登录 请 求 。 
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configure(AuthenticationManagerBuilder) fi 71 i BATH AY UserDetailsService， 并 指定 
了 密码 编码 器 。 此 处 使 用 了 BcryptPasswordEncoder。 读 者 可 能 已 注意 到 ， 当 前 项 目 中 还 未 
实现 UserDetailsService。 对 此 , 将 AppUserDetailsService 添加 至 com.example.placereviewer. 
service 包 中 ， 如 下 所 示 : 


package com.example.placereviewer.service 


import com.example.placereviewer.data.repository.UserRepository 

import org.springframework.security.core.GrantedAuthority 

import org.springframework.security.core.userdetails.User 

import org.springframework.security.core.userdetails.UserDetails 

import org.springframework.security.core.userdetails.UserDetailsService 

import org.springframework.security.core.userdetails 
-UsernameNotFoundException 

import org.springframework.stereotype.Service 

import java.util.ArrayList 


GService 
class AppUserDetailsService(private val userRepository: 
UserRepository) : UserDetailsService ( 


@Throws (UsernameNotFoundException::class) 
override fun loadUserByUsername (username: String): UserDetails ( 
val user = userRepository.findByUsername (username) ?: 
throw UsernameNotFoundException("A user with the username 
Susername doesn't exist") 


return User(user.username, user.password, 
ArrayList<GrantedAuthority>()) 


} 


loadUsername(String) 加 载 用 户 的 UserDetails 〈 与 传递 至 函数 中 的 用 户 名 匹配 的 ) 。 
如 果 未 发 现 匹配 用 户 ， 那 么 将 抛 出 UsernameNotFoundException。 

待 全 部 工作 就 绪 后 ， 即 成 功 地 针对 后 台 应 用 程序 设置 了 Spring Security. 

下 面 将 结束 实体 、 存 储 库 、 服 务 、 服 务实 现 以 及 Spring Security 安全 配置 方面 的 内 容 ， 
并 从 应 用 程序 的 前 端 实现 开始 我 们 的 工作 。 接 下 来 , 我们 将 基于 Spring MVC 的 、 客 户 端 
应 用 程序 的 Web 内 容 服 务 。 
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9.2.10 基于 Spring MVC 的 Web 内 容 服务 


在 Spring MVC 中 ，HTTP 请 求 由 控制 器 进行 处 理 。 这 里 ， 控 制 器 定义 为 一 个 类 ， 并 
通过 @Controller 加 以 注解 一 一 这 与 @RestController 的 注解 方式 十 分 类 似 。 关 于 控制 器 的 
工作 方式 ， 一 种 较 好 的 理解 方式 是 考察 一 个 具体 的 实例 。 下 面 将 构建 一 个 简单 的 Spring 
MVC 控制 器 ， 并 处 理发 送 至 /say/hello 路 径 的 HTTP GET 请 求 〈 通 过 返回 一 个 视图 ) ， 
进而 向 用 户 显示 一 个 HTML 页 面 。 

相应 地 ， 在 com.example.placereviewer 中 创建 一 个 controller 包 ， 并 添加 下 列 类 定义 : 


package com.example.placereviewer.controller 


import org.springframework.stereotype.Controller 
import org.springframework.web.bind.annotation.GetMapping 
import org.springframework.web.bind.annotation.RequestMapping 


@Controller 
@RequestMapping ("/say") 
class HelloController { 


@GetMapping ("/hello") 
fun hello(): String { 
return "hello" 
} 
} 
不 难 发 现 ， 控 制 器 的 创建 过 程 并 不 复杂 。 基 于 @Controller 的 HelloController 注解 通 
知 Spring， 该 类 定义 为 Spring MVC 控制 器 ， 因 而 具备 处 理 HTTP 请 求 操作 能 力 。 此 外 ， 
基于 @RequestMapping("/say") 的 HelloController 注解 行为 表明 , 该 控制 器 处 理 包含 /say 基 
路 径 的 HTTP 请 求 。 当 前 控制 器 中 定义 了 hello0 动 作 ， 由 于 该 动作 采用 @GetMapping 
("hello") 加 以 注解 ， 因 而 将 处 理 /path/hello 路 径 的 请 求 。hello0 返 回 的 字符 串 表 示 为 视图 
资源 名 称 一 一 在 将 某 个 请 求 发 送 至 该 例 程 中 时 ， 将 被 显示 于 客户 端 上 。 
hello0 要 求 名 为 hello 的 视图 返回 至 客户 端 ， 那 么 ， 下 一 项 任务 则 是 将 这 一 类 视图 添 
加 至 当前 项 目 中 。 通 常情 况 下 ,视图 一 般 被 添加 至 Spring Mi H resources 目录 下 的 templates 
文件 夹 中 。 在 templates 上 单 击 鼠 标 右键 ， 在 弹出 的 快捷 菜单 中 选择 New | HTML File fi 
令 ， 进 而 将 hello.html 文件 添加 至 当前 项 目 中 ， 如 图 9.4 所 示 。 
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图 9.4 将 hello.html 文件 添加 至 当前 项 目 中 


用 户 将 被 提示 提供 HTML 页 面 的 名 称 , 这 里 输入 hello 作为 页 面 名 称 , 如 图 9.5 所 示 。 


0ce New HTML File 


he 


Fd 9.5 输入 hello 作为 页 面 名 称 
IntelliJ IDEA 将 在 所 选择 的 目录 中 生成 HTML 文件 。 待 操作 完成 后 ， 即 可 对 其 内 容 


进行 调整 ， 进 而 包含 基本 的 HIML 内 容 ， 如 下 所 示 : 


<!DOCTYPE html» 
<html lang="en"> 
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<head> 
<meta charset="UTF-8"> 
<title>Hello</title> 

</head> 

<body> 

Hello world! 

</body> 

</html> 


接 下 来 将 对 所 创建 的 控制 器 进行 测试 ， 以 查看 在 向 对 应 路 径 发 送 GET 请 求 时 ， 是 否 
返回 了 一 个 包含 “Hello World!” 消 息 的 HTML 页 面 。 相 应 地 ， 需 要 将 GET 请 求 添加 至 
/say/hello 中 ， 并 作为 Spring Security 无 须 验 证 的 请 求 。 针 对 于 此 ， 可 简单 地 调整 
WebSecurityConfig 中 的 configure(HttpSecurity)， 并 支持 /say/hello 路 径 的 GET 请 求 ， 如 
下 所 示 : 


@Throws (Exception::class) 


override fun configure(http: HttpSecurity) ( 
http.authorizeRequests () 
.antMatchers (HttpMethod.GET,"/say/hello") .permitAll() // added line 
.antMatchers (HttpMethod.GET,"/register").permitAll() 
.antMatchers (HttpMethod.POST,"/users/registrations") .permitAll() 
.antMatchers (HttpMethod.GET, "/css/**").permitAll() 
.antMatchers (HttpMethod.GET, "/webjars/**").permitAll() 
.anyRequest () .authenticated() 
-and() 
-formLogin() 
- loginPage ("/login") 
.successHandler { request, response, > 
redirectStrategy.sendRedirect (request, response, "/home") 

) 
.permitAll() 
-and() 
- Logout () 
.permitAll() 

) 


构建 并 运行 Spring 应 用 程序 ， 随 后 开启 Web 浏览 器 并 访问 URL:http:;//localhost: 
5000/say/hello， 对 应 结果 如 图 9.6 所 示 。 
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€ > Œ O localhost:5000/say/hello 


Hello world! 


图 9.6 构建 并 运行 Spring 应 用 程序 
9.3 利用 ELK 管理 Spring 应 用 程序 日 志 


当 构 建 发 布 系统 时 ， 服 务 器 日 志文 件 的 管理 方式 是 一 项 重点 考察 内 容 。 服 务 区 日 志 
是 一 类 日 志文 件 ， 并 通过 服务 器 予以 创建 和 管理 。 日 志文 件 通常 由 服务 器 执行 的 活动 列 
表 构 成 。ELK (Elasticsearch, Logstash 和 Kibana) 栈 则 强调 了 应 用 程序 日 志文 件 的 管理 
方式 ， 本 节 将 学 习 如 何 利用 ELK 栈 实现 Spring 应 用 程序 日 志文 件 的 管理 。 


9.3.1 利用 Spring 生成 日 志 


在 开始 设置 ELK 栈 管理 Spring 日 志 之 前 , 首先 需要 配置 Spring 以 生成 日 志文 件 , 这 
可 通过 Spring 项 目的 application.properties 文件 予以 实现 。 下 面 配置 Place Reviewer 后 台 
应 用 程序 并 生成 日 志 。 

打开 项 目的 application.properties 文件 ， 并 添加 下 列 代码 : 

logging.file-application.log 


上 述 代码 将 配置 Spring， 并 在 application.log 文件 中 生成 、 保 存 服务 器 日 志 。 在 项 目 
下 一 次 启动 时 ， 该 文件 将 在 项 目的 根 目 录 中 创建 并 保存 。 这 一 步骤 对 于 配置 服务 器 日 志 
来 说 不 可 或 缺 。 下 面 将 设置 日 志 栈 ， 并 从 安装 Elasticsearch 开始 。 


9.3.2 ZU Elasticsearch 


安装 Elasticsearch 需要 执行 下 列 步骤 : 
(1) 访问 https:/www.elastic.co/downloads/elasticsearch， 选 择 下 载 ZIP 文件 格式 的 
Elasticsearch 包 。 
(2) FREH, HJE Elasticsearch ZIP 文件 。 
(3) 在 终端 中 运行 Elasticsearch， 即 运行 bin/elasticsearch (Windows 环境 下 为 
bin/elasticsearch.bat) ， 如 图 9.7 所 示 。 
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P i 
gg? elastic Products cloud services Customers Learn downloads [conta Q 


Downloads 


Download Elasticsearch 


© Want to upgrade? We'l give you a hand. Upgrade Guidance » 


Version: 6.1.1 
Release date: December 19, 2017 


Notes: View release notes. 


Not the version you're looking for? View past releases. 


Downloads: — &ZIP sh. STAR sha & DEB sha 


PM st & MSI (BETA) sha 


Installation Steps 


图 9.7 下载、 安装 Elasticsearch 


bin/elasticsearch 执行 完毕 后 ，Elasticsearch 将 在 系统 中 运行 ， 如 图 9.8 所 示 。 


T01:06:09,484 
+UseConcMa 


9.8 在 系统 中 运行 Elasticsearch 
在 终端 上 运行 下 列 命令 ， 检 测 Elasticsearch 是 否 可 正常 运行 。 


curl -XGET http://localhost:9200 
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如 果 一 切 就 绪 ， 即 会 得 到 下 列 响应 结果 。 


{ 
"name" : "Df8YuN2", 
"cluster name" : "elasticsearch", 
"cluster uuid" : "Z8SYAKLNSZaMiGkYz7ihfg", 
"Jarson s 
"number" : "6.1.1". 
"build hash" : "bd92e7f", 
"build date" : "2017-12-17T20:23:25.3382", 
"build snapshot" : false, 
"lucene version" : "7.1.0", 
"minimum wire compatibility version" : "5.6.0", 
"minimum index compatibility version" : "5.0.0" 
), 
"tagline" : "You Know, for Search" 


} 


9.3.3 安装 Kibana 


Kibana 的 安装 过 程 与 Elasticsearch 2S1. £445 BE! 
(1) 访问 https://www.elastic.co/downloads/kibana， 下 载 Kibana 压缩 包 。 
(2) 解压 Kibana。 
(3) 运行 bin/kibana。 
在 下 载 并 运行 Kibana 后 ， 可 启动 浏览 器 并 访问 http://localhost:5601/。 如 果 一 切 工作 
正常 ， 将 会 看 到 如 图 9.9 所 示 的 Kibana Web 页 面 。 


kibana Welcome to Kibana Data already in Elasticsearch? — | Setup index patterns 
© 
bb ov Visualize and Explore Data Manage and Administer the Elastic Stack 
e —— — — "E 
e SB display and sharea interactively explore your Skip cURL and use this Manage the index patterns 
collection of visualizations data by querying and JSON interface to work with that help retrieve your data 
+ and saved searches. fering raw documents. your data direct from Elasticsearch. 
o gr no Saved Objects 
Use an expression Vl create vsuatzatons and Import export and 
language to analyze ume aggregate data stores in manage your saved 
series data and visualize. your Elastisearch indices. searches, visualizations, 
the results. and dashboards 


Didn' find what you were looking for? 


View full directory of Kibana plugins 


图 9.9 启动 Kibana 


* 346 * Kotlin 语言 实例 精 解 


9.3.4 Logstash 


安装 Logstash 需要 执行 下 列 步骤 : 
(1) 访问 https://www.elastic.co/downloads/logstash 并 下 载 ZIP 压缩 包 。 
(2) 解压 Logstash 压缩 包 。 
除了 下 载 并 运行 Logstash 之 外 ， 还 需要 对 其 进行 适当 配置 ， 以 理解 Spring 日 志文 件 
结构 。 因 此 ， 需 要 创建 一 个 Logstash 配置 文件 ， 其 中 包含 了 3 个 较为 重要 的 部 分 ， 即 输 
入 、 过 滤 和 输出 。 每 部 分 内 容 都 设置 了 插件 ， 并 在 日 志文 件 处 理 中 饰演 了 对 应 的 角色 。 
接 下 来 ， 可 在 相关 目录 中 创建 logstash.conf 文件 ， 并 添加 下 列 代码 。 


input ( 
file ( 
type => "java" 
path => "/«path-to-project»/place-reviewer/application.log" 
codec => multiline ( 
pattern => "*%{YEAR}-%{MONTHNUM}-%{MONTHDAY} %{TIME}.*" 
negate => "true" 
what => "previous" 
} 
} 
} 


filter { 
#Tag log lines containing tab character followed by 'at' as stacktrace. 
if [message] =~ "Ntat" { 
grok { 
match => ["message", "*(\tat)"] 
add_tag => ["stacktrace"] 
} 
} 
#Grok Spring Boot's default log format 
grok { 
match => [ "message", 
"(2<timestamp>% { YEAR} -% {MONTHNUM}-%{MONTHDAY} %{TIME}) 
%{LOGLEVEL: level} %{NUMBER:pid} --- \[(?<thread> 
[A-Za-z0-9-]+) \] [A-Za—z0-9.]*\. (?<class> 
[A-Za-z0-9#_]+) \s*:\s+(?<logmessage>.*)", 
"message", 
"(2<timestamp>% { YEAR} -—% {MONTHNUM}-%{MONTHDAY} %{TIME}) 
%{LOGLEVEL: level} %{NUMBER:pid} --- .+? 
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:\s+(?<logmessage>.*)" 
) 


#Parsing timestamps in timestamp field 
date { 
match => [ "timestamp" , "yyyy-MM-dd HH:mm:ss.SSS" ] 
} 
} 


output { 
# Print each event to stdout and enable rubydebug. 
stdout { 
codec => rubydebug 
} 
# Send parsed log events to Elasticsearch 
elasticsearch { 
hosts => ["127:0.0.1"] 
} 
} 


解释 全 部 插件 超出 了 本 书 的 讨论 范围 ， 读 者 可 留意 相关 注释 以 理解 代码 的 功能 。 另 


外 ， 还 应 将 输入 部 分 文件 插件 中 的 path 路 径 修改 为 Place Reviewer 应 用 程序 的 
application.log 文件 的 绝对 路 径 。 


当 Logstash 配置 文件 处 理 完毕 后 ， 利 用 下 列 命令 运行 Logstash: 
/bin/logstash -f logstash.conf 


如 果 一 切 配置 顺利 ，Logstash 将 开始 存储 日 志 事件 。 最 后 一 项 工作 是 配置 Kibana， 


并 读 取 存储 数据 。 
9.3.5 配置 Kibana 


Kibana 的 配置 过 程 较为 简单 ， 进 而 可 读 取 存 储 于 Elasticsearch 索引 中 的 日 志 。 对 此 ， 


可 访问 Kibana Web UI Chttp://localhost:5601/) ， 单 击 左 侧 导航 栏 上 的 Management， 进 而 
访问 设置 管理 页 面 。 在 配置 Kibana 时 ， 首 先 需 要 生成 索引 模式 。 对 此 ， 可 单 击 管理 页 面 


g 


HAY Index Patterns， 并 管理 Kibana 所 识别 的 索引 模式 ， 如 图 9.10 所 示 。 
鉴于 首次 创建 索引 模式 ， 因 而 将 显示 如 图 9.11 所 示 的 提示 画面 。 
在 Index pattern 文本 框 中 输入 Kibana 所 识别 的 索引 名 《显示 于 当前 页 面 中 ) ， 随 后 


可 执行 下 一 个 步骤 。 此 时 需要 选取 Time Filter field name， 如 图 9.12 所 示 。 
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Management 


Version: 6.1.1 


区 Kibana 


Dashboard 


Timelion Index Patterns Saved Objects Advanced Settings 


Dev Tools 


Management 


localhost:5601/app/kibanad/management/kibana/indices) 


图 9.10 索引 模式 


Management / Kibana 


Index Patterns Saved Objects Advanced Settings 


EA ‘default Index pattern. Create index pattern Include system indices 
Youmustselectorcreste Kibana uses index patterns to retrieve data from Elasticsearch indices for things like visualizations. 


Step 1 of 2: Define index pattern 
ston 


Index pattern 


Index-name* 


Dev Tool 


z You can use a * as a wildcard in your index pattern. 


You can't use empty spaces or the characters V/? * <> | Next step > 


Your index pattern can match any of your 1 Indices, below 


logstash-201801.13 


Collapse 


图 9.11 提示 信息 


= Management 7 Kibana 
[4 kibana Index Patterns Saved Objects Advanced Settings 


Discover 


Em default Index pattern. Create index pattern 
You must selector create Kibana uses index patterns to retrieve data from Elasticsearch indices for things like visualizations. 
one to connue, 
Dashboard 
Step 2 of 2: Configure settings 
You've defined logstash-2018.01.13 as your index pattern. Now you can specify some settings before we create it 
Dev Tool 
Time Filter field name Refresh 


Management @timestamp Ls 


The Time Filter will use this field to filter your data by time. You can choose not to have a time field, but you will not be able to 
narrow down your data by a time range. 


» Show advanced options 


图 9.12 选取 Time Filter field name 
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此 处 可 选取 下 拉 菜 单 中 的 @timestamp。 随后， 单 击 Create index pattern 按钮 结束 索引 
模式 的 创建 过 程 。 通 过 选择 Index Patterns， 读 者 可 从 设置 管理 页 面 中 随时 管理 索引 模式 。 
图 9.13 显示 了 保存 后 的 模式 。 


Management / Kibana 


Index Patterns Saved Objects Advanced Settings 


K logstash-2018.01.13 
[ C Time riter fed name: edmestamp | 


This page lists every field in the logstash-2018.01.13 index and the field's associated core type as recorded by Elasticsearch. While this 
list allows you to view the core type of each field, changing field types must be done using Elasticsearch's Mapping API % 


* logstash201801.18. 


fields (32) scripted fields (0) source filters (0) 


Q Filter Allfield types ~ 
name > s $ searchable © aggregatable@= excluded): controls 
eumesamp 回 * v 7 
@version 


~ 
aid ~ 
~ 


-jndex 
-store 
-source 
type 

class 

class. keyword 
geoipip. 
geolpJatitude 


图 9.13 查看 保存 后 的 模式 
至 此 ，Kibana 的 配置 过 程 暂 告 一 段落 。 


9.4 本 章 小 结 


本 章 深 入 讨论 了 Web 开发 中 Kotlin 语言 及 其 应 用 ， 并 实现 了 Place Reviewer 应 用 程 
序 。 除 此 之 外 ， 我 们 还 学 习 了 如 何 配置 Spring 框架 项 目 ， 并 采用 Spring MVC 构建 基于 
MVC 设计 模式 的 应 用 程序 。 进 一 步 讲 ， 本 章 介 绍 了 Spring Security 的 配置 方式 ， 以 防止 
Spring Web 应 用 程序 中 未 经 验证 的 访问 行为 。 最 后 ， 本 章 还 考察 了 ELK 栈 ， 以 及 如 何 管 
理 服务 器 栈 。 

第 10 章 将 完成 Place Reviewer 应 用 程序 ， 并 实现 其 前 端 内 容 。 在 前 端 实现 过 程 中 ， 
读者 将 学 习 如 何 利 用 Google Places API 构建 富 Web 应 用 程序 ， 并 对 Spring 框架 构建 的 
Web 应 用 程序 进行 测试 。 
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第 9 章 通过 构建 Place Reviewer 网 站 ， 继 续 讨 论 了 Kotlin 语言 在 Web 应 用 程序 设计 
中 的 应 用 。 其 中 涉及 MVC 模式 ， 并 从 高 层 视 角 考 察 MVC 应 用 程序 中 的 主要 组 件 ， 包 括 
模型 、 视 图 以 及 控制 器 。 在 读者 理解 了 MVC 设计 模式 及 其 工作 方式 后 ， 第 9 章 还 针对 
Place Reviewer 应 用 程序 介绍 了 其 设计 和 实现 方案 。 

在 第 9 章 中 ， 首 先 介绍 了 应 用 程序 用 例 ， 随 后 是 构建 应 用 程序 所 需 的 数据 ， 在 数据 
标识 完毕 后 ， 接 下 来 探讨 了 后 端 应 用 程序 开发 ， 同 时 设置 了 与 应 用 程序 通信 的 数据 库 ， 
并 实现 了 应 用 程序 所 需 的 实体 和 模型 。 

最 后 ,我 们 还 通过 Spring Security 进一步 探讨 了 Place Reviewer 应 用 程序 的 安全 问题 ， 
即 验 证 操作 (未 采用 JWT) 。 最 后 ， 读 者 还 学 习 了 如 何 创建 Spring MVC 应 用 程序 的 控 
制 器 ， 以 及 如 何 利用 ELK 栈 管理 服务 器 日 志 。 

本 章 将 介绍 Place Reviewer 应 用 程序 的 前 端 开 发 ,进而 完善 该 程序 的 所 有 内 容 。 本 章 
主要 涉及 以 下 内 容 : 

口 与 Google Places API 协同 工作 。 

口 ”应 用 程序 测试 。 

口 向 AWS 部 署 Web 应 用 程序 。 

下 面 开 始 着 手 讨论 视图 的 实现 过 程 。 


10.1 利用 Thymeleaf 生成 视图 


如 前 所 述 , 视图 是 应 用 程序 创建 的 数据 表达 方式 , 也 是 用 户 与 MVC 模式 应 用 程序 之 
间 的 主要 交互 点 。 视 图 层 利用 多 种 不 同 的 技术 向 用 户 显 示 相关 信息 。Spring 支持 多 种 视 
图 选择 方案 ， 即 模板 。Spring 应 用 程序 中 的 模板 功能 通过 模板 引擎 予以 提供 。 简 单 地 讲 ， 
模板 引擎 允许 使 用 应 用 程序 的 视图 层 的 静态 模板 文件 。 此 外 ， 模 板 引擎 也 称 作 模板 库 。 
Spring 支持 下 列 模板 库 的 应 用 : 

ü Thymeleaf. 

DD Freemaker. 

Q Tiles. 


第 103i 实现 Place Reviewer 前 端 *351* 


Q Velocity. 

实际 内 容 远 不 止 于 此 ， 还 存在 许多 其 他 的 模板 库 可 供 Spring 使 用 。 本 章 将 利 
Thymeleaf 向 应 用 程序 提供 模板 处 理 支 持 。 回 忆 一 下 ， 在 项 目的 开始 阶段 ,我 们 曾 纳入 
基于 Thymeleaf 的 模板 支持 功能 。 具 体 来 说 ， 在 项 目 pom.xml 文件 的 依赖 关系 中 ， 曾 
项 目 中 添加 了 Thymeleaf， 如 下 所 示 : 


<dependencies> 


aw dB 


<dependency> 
XgroupId»org.springframework.boot«/groupId» 
<artifactId>spring-boot-starter-thymeleaf</artifactId> 
</dependency> 


</dependencies> 


关于 Thymeleaf 的 正式 定义 ,其 官方 网 站 中 描述 到 : Thymeleaf 是 一 类 针对 Web 和 单 
机 环境 的 服务 器 端 Java 模板 引擎 ， 旨 在 向 开发 工作 流 中 添加 模板 一 一 HTML 将 能 够 正确 
地 显示 于 浏览 器 中 ， 并 以 静态 原型 工作 ， 人 允许 在 开发 团队 中 进行 更 强 的 协作 。 关 于 
Thymeleaf 及 其 设计 目标 ， 读 者 可 访问 http://thymeleaf.org 以 了 解 更 多 内 容 。 

第 9 章 曾 讨论 一 个 简单 示例 ， 并 针对 HelloController 实现 了 一 个 hello.html 视图 ， 但 
所 生成 的 视图 仅 向 用 户 显示 了 “Hello world!” 消 息 ， 本 章 将 介绍 一 些 更 复杂 的 视图 。 我 
们 首先 创建 一 个 视图 ， 以 方便 用 户 在 平台 上 进行 注册 。 


10.1.1 实现 用 户 注册 视图 


本 节 将 完成 两 项 任务 。 首 先 将 创建 一 个 视图 层 , 并 在 Place Reviewer 平台 上 实现 新 用 
户 的 注册 过 程 。 其 次 ， 将 创建 相应 的 控制 器 和 动作 ， 并 利用 注册 视图 显示 用 户 ， 随 后 处 
理 注册 表单 提交 操作 。 对 此 ， 可 在 Place Reviewer 项 目 中 设置 register.html 模板 。 回 忆 一 
下 ， 全 部 模板 文件 均 位 于 resources 的 templates 目录 下 。 下 面 将 下 列 模板 HTML 添加 至 
当前 文件 中 。 


<!DOCTYPE html» 
<html lang-"en" xmlns:th-"http://www.thymeleaf.org"» 
<head> 
<title>Register</title> 
<link rel="stylesheet" th:href="@{/css/app.css}"/> 
<link rel="stylesheet" 
href-"/webjars/bootstrap/4.0.0-beta.3/css/bootstrap.min.css"/» 
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<script src="/webjars/jquery/3.2.1/jquery.min.js"></script> 
<script src-"/webjars/bootstrap/4.0.0-beta.3/ 
js/bootstrap.min.js"></script> 
</head> 
<body> 
«nav class="navbar navbar-default nav-enhanced"» 
<div class-"container-fluid container-nav"» 
<div class-"navbar-header"» 
<div class-"navbar-brand"» 
Place Reviewer 
«/div» 
«/div» 
<ul class-"navbar-nav" th:if="${principal != null}"> 
<li> 
<form th:action="@{/logout}" method="post"> 
<button class="btn btn-danger" type="submit"> 
<i class="fa fa-power-off" aria-hidden="true"></i> 
Sign Out 
</button> 
</form> 
</li> 
</ul> 
</div> 
</nav> 
<div class="container-fluid" style="z-index: 2; position: absolute"> 
<div class="row mt-5"> 
<div class="col-sm-4 col-xs-2"> </div> 
<div class-"col-sm-4 col-xs-8"» 
<form class-"form-group col-sm-12 form-vertical form-app" 
id-"form-register" method-"post" 
th:action="@{/users/registrations}"> 
<div class-"col-sm-12 mt-2 lead text-center text-primary"» 
Create an account 
«/div» 
<hr> 
<input class-"form-control" type="text" name-"username" 
placeholder-"Username" required/> 
<input class-"form-control mt-2" type-"email" name-"email" 


placeholder-"Email" required/» 
<input class-"form-control mt-2" type="password" name-"password" 
placeholder-"Password" required/» 
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<span th:if="${error != null)" class-"mt-2 text-danger" 
style-"font-size: 10px" th:text="${error}"></span> 
<button class-"btn btn-primary form-control mt-2 mb-3" 
type="submit"> 
Sign Up! 
</button> 
</form> 
</div> 
<div class-"col-sm-4 col-xs-2"»«/div» 
«/div» 
«/div» 
</body> 
</html> 


上 述 代码 片段 使 用 了 HTML 针对 用 户 注册 页 面 生成 模板 。Web 页 面 自身 较为 简单 。 
仅 包含 了 导航 栏 以 及 一 个 表单 ， 用户 可 于 其 中 输入 提交 所 需 的 注册 信息 。 作 为 Thymeleaf 
模板 ， 使 用 一 些 基 于 Thymeleaf 的 特定 属性 也 较为 合理 ， 下 面 考察 其 中 的 一 些 属性 。 
O th:href。 该 属性 表示 为 修饰 符 属 性 。 当 模板 引擎 对 此 加 以 处 理 时 ， 将 计算 所 用 的 
链接 URL, 并 将 其 设置 于 所 用 的 标签 中 。 例 如 , 该 属性 所 用 的 标签 包括 <a> 和 <link>。 
下 列 代码 片段 使 用 了 th:href 属性 : 


<link rel="stylesheet" th:href="@{/css/app.css}"/> 


口 th:action。 该 属性 的 工作 方式 类 似 于 HTML 动作 属性 ， 当 提交 表单 时 用 于 指定 表 
单数 据 的 发 送 位 置 。 下 列 代码 片段 表明 ， 表 单数 据 应 发 送 至 包含 /users/ 
registrations 路 径 的 端点 位 置 处 。 

«form class-"form-group col-sm-12 form-vertical form-app" 


id-"form-register" method-"post" 
th:action="@{/users/registrations}"> 


</form> 

口 ” 了 th:text。 该 属性 用 于 确定 HTML 标签 是 否 可 根据 条 件 测试 结果 予以 显示 ， 如 下 
Pras: 

<span th:if="${error !- null)" class-"mt-2 text-danger" 


style="font-size: 10px" th:text="${error}"></span> 


在 上 述 代 码 中 ， 如 果 存 在 模型 属性 错误 ， 且 对 应 值 不 等 于 null， 那 么 ，span 标签 将 
显示 于 HTML 页 面 上 ; 否则 将 不 予 显 示 。 
除 此 之 外 ， 导 航 栏 中 还 使 用 了 也 :站 ， 表 明 何 时 显示 一 个 按钮 ， 以 使 用 户 可 注销 其 账 
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号 ， 如 下 所 示 : 


<ul class="navbar-nav" th:if="${principal != null}"> 
<li> 


<form th:action="@{/logout}" method="post"> 
<button class="btn btn-danger" type="submit"> 
<i class="fa fa-power-off" aria-hidden-"true"»«/i» Sign Out 
</button> 
</form> 
</li> 
</ul> 


如 果 模 板 中 设置 了 principal 模型 属性 且 不 为 null， 那 么 将 会 显示 注销 按钮 。 除 非 用 
户 登 录 其 账号 ， 否 则 principal 一 直 为 null. 

初 看 之 下 ， 导 航 栏 于 模板 间 的 直接 添加 方式 尚且 令 人 满意 ， 但 需要 注意 的 是 ， 在 应 
用 程序 中 多 次 使 用 导航 条 DOM 元 素 是 很 常见 的 事情 , 因而 不 应 在 模板 中 多 次 重复 编写 相 
同 的 代码 。 为 了 避免 不 必要 的 重复 性 工作 ， 需 要 将 导航 栏 实现 为 片段 ， 并 可 随时 将 其 纳 
入 模板 中 。 

在 templates 中 创建 fragments 目录 ， 添 加 navbar.html 文件 并 输入 下 列 代码 : 

«!DOCTYPE html» 


<html lang="en" xmlns:th="http://www.thymeleaf.org"> 
<head> 
<meta charset="UTF-8"> 
</head> 
<body> 


«nav class="navbar navbar-default nav-enhanced" th: fragment="navbar"> 
<div class-"container-fluid container-nav"> 
<div class-"navbar-header"» 
<div class="navbar-brand"> 
Place Reviewer 
</div> 
</div> 
<ul class-"navbar-nav" th:if="${principal !- null}"> 
<li> 
<form th:action="@{/logout}" method="post"> 
<button class="btn btn-danger" type="submit"> 
<i class="fa fa-power-off" aria-hidden="true"></i> Sign Out 
</button> 
</form> 
</li> 
</ul> 


第 10 章 实现 Place Reviewer 前 端 *355* 


«/div» 
</nav> 
</body> 
</html> 


上 述 代码 片段 利用 th:fragment 属性 定义 了 模板 所 支持 的 导航 栏 片段 。 当 使 用 th:insert 
时 ， 可 随时 将 定义 后 的 片段 插入 模板 中 。 修 改 register.html 文件 中 <body> 标 签 的 内 部 
HTML， 并 使 用 最 新 定义 的 判断 ， 如 下 所 示 : 


<!DOCTYPE html» 
Xhtml lang-"en" xmlns:th="http://www.thymeleaf.org"> 
<head> 

<title>Register</title> 
<link rel="stylesheet" th:href="@{/css/app.css}"/> 
<link rel="stylesheet" 
href-"/webjars/bootstrap/4.0.0-beta.3/css/bootstrap.min.css"/» 
<script src="/webjars/jquery/3.2.1/jquery.min.js"></script> 
<script src-"/webjars/bootstrap/4.0.0-beta.3/ 
js/bootstrap.min.js"></script> 


</head> 

<body> 
<div th:insert="fragments/navbar :: navbar"></div> 
<!-- inserting navbar fragment --> 


<div class="container-fluid" style="z-index: 2; position: absolute"> 
<div class="row mt-5"> 
<div class-"col-sm-4 col-xs-2"» 
«/div» 
<div class-"col-sm-4 col-xs-8"» 

«form class-"form-group col-sm-12 form-vertical form-app" 
id-"form-register" method-"post" 
th:action="@{/users/registrations}"> 

<div class-"col-sm-12 mt-2 lead text-center text-primary"» 
Create an account 


</div> 

<hr> 

<input class="form-control" type="text" name-"username" 
placeholder-"Username" required/> 


<input class="form-control mt-2" type-"email" name-"email" 
placeholder-"Email" required/» 

<input class-"form-control mt-2" type="password" 
name-"password" placeholder-"Password" required/» 

<span th:if="${error != null}" class-"mt-2 text-danger" 
style="font-size: 10px" th:text="${error}"></span> 
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<button class-"btn btn-primary form-control mt-2 mb-3" 
type="submit"> 
Sign Up! 
</button> 
</form> 

</div> 

<div class-"col-sm-4 col-xs-2"»«/div» 

«/div» 

«/div» 
</body> 
</html> 


不 难 发 现 ， 导 航 条 HTML 与 片段 的 分 离 使 代码 更 加 简洁 ， 并 有 助 于 提升 模板 的 开发 
质量 。 
当 对 用 户 注册 页 面 设 置 了 相关 模板 后 ， 即 可 确定 控制 器 ， 并 向 站 点 的 访问 用 户 显 示 
该 模板 。 下 面 定义 应 用 程序 的 控制 器 , 并 向 请 求 用 户 显 示 Place Reviewer 应 用 程序 的 Web 


页 面 。 
向 controller 包 中 添加 ApplicationController 类 ， 如 下 所 示 : 


package com.example.placereviewer.controller 


import org.springframework.stereotype.Controller 
import org.springframework.web.bind.annotation.GetMapping 


@Controller 
class ApplicationController { 


@GetMapping ("/register") 
fun register(): String { 
return "register" 
} 
} 
上 述 代码 片段 并 无 特别 之 处 ,其 中 创建 了 一 个 包含 单一 动作 的 MVC 控制 器 , 通过 向 
用 户 显示 register.html 视图 ， 处 理 /register 下 的 HITP GET 请 求 。 
在 查看 新 创建 的 注册 页 面 之 前 ， 还 需要 添加 register.html 所 需 的 app.css 文件 。 诸 如 
CSS 文件 这 一 类 静态 资源 应 添加 至 应 用 程序 resource 目录 下 的 static 目录 中 。 相 应 地 ， 在 
static 目录 下 生成 css 目录 ， 并 加 入 包含 下 列 代码 的 app.css 文件 。 


//app.css 
.nav-enhanced { 
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background-color: #00BFFF; 

border-color: blueviolet; 

box-shadow: 0 0 3px black; 
} 


-container-nav { 
height: 10%; 
width: 100%; 
margin-bottom: 0; 


} 


-form-app { 
background-color: white; 
box-shadow: 0 0 1px black; 
margin-top: 50px !important; 
padding: 10px 0; 

} 


下 面 可 尝试 运行 Place Reviewer 应 用 程序 。 当 应 用 程序 启动 时 , 可 打开 浏览 器 并 访问 
http://localhost:5000/register 页 面 。 

接 下 来 ， 我 们 需要 实现 用 户 注 册 过 程 中 的 逻辑 内 容 。 针 对 于 此 ， 应 声明 一 个 动作 ， 
接收 注册 表单 提供 的 表单 数据 ， 并 对 此 类 数据 进行 适当 处 理 ， 旨 在 平台 上 成 功 地 注册 用 
户 。 如 果 读 者 还 记得 ， 表 单数 据 应 通过 POST 发 送 至 /users/registrations。 最 终 ， 我 们 需要 
定义 一 个 动作 ， 并 处 理 此 类 HTTP 请 求 。 下 面向 com.example.placereviewer.controller 包 
中 添加 UserController 类 ， 对 应 代码 如 下 所 示 : 


package com.example.placereviewer.controller 


import com.example.placereviewer.component.UserValidator 
import com.example.placereviewer.data.model.User 

import com.example.placereviewer.service.SecurityService 
import com.example.placereviewer.service.UserService 

import org.springframework.stereotype.Controller 

import org.springframework.ui.Model 

import org.springframework.validation.BindingResult 

import org.springframework.web.bind.annotation.GetMapping 
import org.springframework.web.bind.annotation.ModelAttribute 
import org.springframework.web.bind.annotation.PostMapping 
import org.springframework.web.bind.annotation.RequestMapping 


GController 
GRequestMapping ("/users") 
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class UserController(val userValidator: UserValidator, 
val userService: UserService, val securityService: SecurityService) { 


@PostMapping ("/registrations") 
fun create (@ModelAttribute form: User, bindingResult: 
BindingResult,model: Model): String ( 
userValidator.validate(form, bindingResult) 


if (bindingResult.hasErrors()) ( 
model.addAttribute("error", bindingResult.allErrors.first() 
-defaultMessage) 
model.addAttribute ("username", form.username) 
model.addAttribute ("email", form.email) 
model.addAttribute("password", form.password) 


return "register" 


) 


userService.register(form.username, form.email, form.password) 
securityService.autoLogin(form.username, form.password) 


return "redirect: /home" 
) 

) 

create() 处 理发 送 至 /users/registrations 的 HTTP POST 请 求 ， 并 接收 3 个 参数 。 其 中 ， 
第 一 个 参数 为 表单 ， 即 User 类 对 象 。@ModelAttribute 用 于 注解 form. @ModelAttribute 
表明 ， 当 前 参数 应 通过 模型 获取 。 表 单 模型 属性 由 表单 提交 给 端点 的 数据 填充 。 此 外 ， 
usemame、email 和 password 均 由 注册 表单 所 提交 。 所 有 的 User 类 型 对 象 均 包 含 username、 
email 和 password 属性 。 因 此 ， 表 单 提 交 的 数据 将 赋予 至 对 应 的 模型 属性 中 。 

函数 的 第 二 个 参数 表示 为 BindingResult 实例 。BindingResult 作为 DataBinder 的 持 有 
者 ， 此 处 用 于 绑 定 UserValidator 所 执行 的 验证 处 理 结 果 ， 稍 后 将 对 此 加 以 定义 。 函 数 的 
第 三 个 参数 为 Model， 据 此 可 将 属性 添加 至 模型 中 ， 以 供 视图 层 的 后 续 访 问 使 用 。 

在 进一步 解释 create0 动 作 的 实现 逻辑 之 前 ， 需 要 实现 UserValidator 和 SecurityService. 
UserValidator 的 唯一 任务 是 验证 提交 至 后 台 的 用 户 数据 。 对 此 ， 可 定义 com.example. 
placereviewer.component 包 ， 并 于 其 中 定义 UserValidator 类 ， 如 下 所 示 : 


package com.example.placereviewer.component 


import com.example.placereviewer.data.model.User 
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import com.example.placereviewer.data.repository.UserRepository 
import org.springframework.stereotype.Component 

import org.springframework.validation.Errors 

import org.springframework.validation.ValidationUtils 

import org.springframework.validation.Validator 


@Component 
class UserValidator (private val userRepository: UserRepository) : Validator 


{ 


override fun supports(aClass: Class<*>?): Boolean { 
return User::class == aClass 


override fun validate(obj: Any?, errors: Errors) { 
val user: User = obj as User 


下 列 代码 验证 所 提交 的 用 户 参 数 是 否 为 空 。 对 于 空 参 数 ， 将 显示 相应 的 错误 代码 和 
BRI e 
ValidationUtils.rejectIfEmptyOrWhitespace(errors, "username", 
"Empty.userForm.username", "Username cannot be empty") 
ValidationUtils.rejectIfEmptyOrWhitespace (errors, "password", 
"Empty.userForm.password", "Password cannot be empty") 


ValidationUtils.rejectIfEmptyOrWhitespace(errors, "email", 
"Empty.userForm.email", "Email cannot be empty") 


下 列 代码 用 于 验证 所 提交 用 户 名 的 长 度 ， 对 应 长 度 不 应 小 于 6。 


if (user.username.length < 6) { 
errors.rejectValue ("username", "Length.userForm.username", 
"Username must be at least 6 characters in length") 


下 列 代码 验证 所 提交 的 用 户 名 是 否 已 存在 : 


if (userRepository.findByUsername(user.username) != null) { 
errors.rejectValue("username", "Duplicate.userForm.username", 
"Username unavailable") 


} 
验证 所 提交 密码 长 度 。 此 处 ， 密 码 长 度 不 应 小 于 8 个 字符 。 


if (user.password.length < 8) { 
errors.rejectValue ("password", "Length.userForm.password", 
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"Password must be at least 8 characters in length") 


} 
UserValidator 实现 了 Validator 接口 ， 并 用 于 验证 对 象 。 因 此 ，UserValidator 78 5j Y 


两 个 方法 ， 即 supports(Class<*>?) 和 validate(Any?，Errors)。supports0 用 于 判断 验证 器 是 
否 可 验证 提供 给 它 的 对 象 。 对 于 UserValidator，supports0 检 测 所 提供 的 对 象 是 否 为 User 
类 实例 。 因 此 ， 全 部 User 类 型 的 对 象 均 支 持 UserValidator 验证 。 


息 。 


validate() 将 对 所 提供 的 对 象 进行 验证 。 如 果 验 证 失败 ， 则 利用 Error 对 象 注册 错误 信 
另外 ， 读 者 还 应 留意 validate( 方 法 中 的 注释 内 容 ， 以 进一步 了 解 相关 功能 。 
下 面 开始 着 手 处 理 SecurityService， 并 尝试 实现 SecurityService， 以 简化 登录 用 户 的 


验证 操作 ， 以 及 注册 用 户 的 自动 登录 问题 。 


这 里 , 可 向 com.example.placereviewer.service 中 添加 SecurityService 接口 , 如 下 所 示 : 


package com.example.placereviewer.service 


interface SecurityService { 
fun findLoggedInUser(): String? 
fun autoLogin(username: String, password: String) 


} 


接 下 来 ， 向 com.example.placereviewer.service 中 添加 SecurityServiceImpl 类 。 顾 名 思 
SecurityServiceImpl 实现 了 SecurityService 接口 ， 如 下 所 示 : 


package com.example.placereviewer.service 


import org.springframework.beans.factory.annotation.Autowired 

import org.springframework.security.authentication.AuthenticationManager 
import org.springframework.security.authentication. 
UsernamePasswordAuthenticationToken 

import org.springframework.security.core.context.SecurityContextHolder 
import org.springframework.security.core.userdetails.UserDetails 
import org.springframework.stereotype.Service 


GService 
class SecurityServiceImpl(private val userDetailsService: 
AppUserDetailsService) 

: SecurityService { 


@Autowired 


第 10 章 实现 Place Reviewer 前 端 s: 


361* 


lateinit var authManager: AuthenticationManager 
override fun findLoggedInUser(): String? { 
val userDetails = SecurityContextHolder.getContext () 
-authentication.details 
if (userDetails is UserDetails) ( 
return userDetails.username 


return null 


override fun autoLogin(username: String, password: String) ( 
val userDetails: UserDetails - userDetailsService 
-loadUserByUsername (username 


val usernamePasswordAuthenticationToken - 


) 


UsernamePasswordAuthenticationToken (userDetails, password, 


userDetails.authorities) 
authManager.authenticate (usernamePasswordAuthenticationToken) 
if (usernamePasswordAuthenticationToken.isAuthenticated) ( 


SecurityContextHolder.getContext ().authentication = 
usernamePasswordAuthenticationToken 


} 


findLoggedInUserO 用 于 返回 当前 登录 用 户 的 用 户 名 。Username 的 检索 借助 于 Spring 


框架 的 SecurityContextHolder 类 完成 。UserDetails 实例 的 检索 方式 可 描述 为 : 


调用 


SecurityContextHolder.getContextO.authentication.details， 并 访问 登录 用 户 的 验证 信息 。 需 


要 注意 的 是 ，SecurityContextHolder.getContext().authentication.details 返回 一 个 Objec 


t， 而 


非 UserDetails 实例 。 因 此 ， 此 处 需要 执行 类 型 检测 ， 以 确保 当前 所 检索 的 对 象 也 符合 


UserDetails 类 型 。 若 是 ， 则 返回 当前 登录 用 户 的 用 户 名 ;和 否则 返回 null. 


在 完成 了 平台 注册 后 ，autoLogin0 方 法 用 于 执行 简单 的 用 户 验 证 工作 。 其 间 ， 所 提交 


的 用 户 名 和 密码 作为 参数 传递 至 autoLogin0 中; 随后 ， 将 针对 注册 用 户 


生成 


UsernamePasswordAuthenticationToken。 待 UsernamePasswordAuthenticationToken Siye 


be 


后 ， 可 利用 AuthenticationManager 验证 用 户 令 牌 。 若 UsernamePasswordAuthenticationToken 验 
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证 成 功 ， 则 将 当前 用 户 的 验证 属性 设置 为 UsernamePasswordAuthenticationToken. 
在 完成 了 必要 的 类 定义 后 ， 下 面 返 回 至 UserController 以 结束 对 create0 的 讨论 。 在 
create() 中 ， 首 先 利用 UserValidator 实例 验证 所 提交 的 表单 输入 。 此 处 ， 表 单数 据 验 证 过 
程 中 出 现 的 错误 都 与 Spring 置 于 控制 器 中 的 BindingResult 实例 绑 定 在 一 起 。 考 察 下 列 代 
码 片段 : 
if (bindingResult.hasErrors()) { 
model.addAttribute("error", bindingResult.allErrors 
-first().defaultMessage) 
model.addAttribute("username", form.username) 


model.addAttribute("email", form.email) 
model.addAttribute ("password", form.password) 


return "register" 
) 
代码 首先 检测 bindingResult， 进 而 判断 表单 数据 验证 过 程 中 是 否 产生 错误 。 当 发 生 
缘 误 时 ， 将 检索 第 一 个 错误 的 消息 ， 并 设置 一 个 model 属性 错误 ， 以 保存 错误 消息 ， 以 
便 后 续 视图 进行 访问 。 除 此 之 外 ， 还 可 创建 model 属性 ， 并 加 载 用 户 提交 的 每 项 输入 。 
最 后 ， 还 需要 重新 问 用 户 显示 注册 视图 。 
在 上 述 代 码 片 段 中 ， 应 注意 针对 同一 Model 实例 的 多 个 方法 调用 。 对 此 ， 一 种 较为 
清晰 的 方法 是 利用 Kotlin 中 的 with 函数 ， 如 下 所 示 : 
if (bindingResult.hasErrors()) ( 
with (model) ( 
addAttribute ("error", bindingResult.allErrors.first().defaultMessage) 
addAttribute("error", form.username) 
addAttribute("email", form.email) 
addAttribute "password", form.password) 
} 


return "register" 


} 

其 中 不 难 发 现 with 函数 的 简单 方便 之 处 。 因 此 ,可 使 用 with 函数 ,并 对 UserController 
进行 适当 调整 。 

此 处 读者 可 能 会 产生 疑问 ， 为 何 要 将 用 户 的 提交 数据 存储 于 模型 属性 中 呢 ? 其 原因 
是 为 了 能 够 存在 一 种 方法 ， 可 将 注册 表单 中 的 数据 重 置 为 重新 显示 注册 视图 后 所 提交 的 
AÈ: 否则 ， 即 使 仅 存在 一 个 无 效 表单 输入 ， 用 户 也 必须 反复 输入 所 有 表单 数据 ， 这 无 
KEAS RBA TE 
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若 用 户 提交 的 输入 内 容 均 为 有 效 ， 则 执行 下 列 代码 : 


userService.register(form.username, form.email, form.password) 
securityService.autoLogin(form.username, form.password) 
return "redirect:/home" 


正如 期 望 的 那样 ， 当 用 户 提交 的 数据 有 效 ， 将 在 平台 上 进行 注册 ， 并 自动 登录 至 其 
账号 。 最 后 ， 该 用 户 将 被 重 定向 至 其 主页 上 。 在 体验 注册 表单 之 前 ， 还 需要 完成 以 下 两 
项 工作 : 

(1) 使 用 定义 于 register.html 中 的 模型 属性 。 

(2) 创建 home.html 模板 ， 以 及 显示 该 模板 的 控制 器 。 

上 述 两 项 任务 均 较 为 简单 。 首 先 通过 model 属性 修改 registerhtml 中 的 表单 ， 如 下 所 示 : 


«form class-"form-group col-sm-12 form-vertical form-app" 
id="form-register" method="post" th:action="@{/users/registrations}"> 
<div class="col-sm-12 mt-2 lead text-center text-primary"> 
Create an account 
</div> 
<hr> 
<!-- utilized model attributes with th:value --> 
<input class="form-control" type="text" name="username" 
placeholder="Username" th:value="${username}" required/> 
<input class="form-control mt-2" type="email" name="email" 
placeholder="Email" th:value="${email}" required/> 
<input class-"form-control mt-2" type="password" name-"password" 
placeholder-"Password" th:value="${password}" required/» 
<span th:if="${error !- null)" class-"mt-2 text-danger" 
style-"font-size: 10px" th:text="${error}"></span> 
<button class="btn btn-primary form-control mt-2 mb-3" type="submit"> 
Sign Up! 
</button> 
</form> 


上 述 代码 使 用 了 Thymeleaf 的 th:value 模板 属性 ， 并 将 表单 输入 中 的 值 预 置 于 相应 的 
model 属性 值 中 。 下 面 定 义 一 个 简单 的 home.html 模板 ， 并 将 home.html 模板 添加 至 
templates 目录 中 ， 如 下 所 示 : 


«html» 
<head> 
<title> Home</title> 
</head> 
<body> 
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You have been successfully registered and are now in your home page. 
</body> 
</html> 


更 新 ApplicationController， 并 包含 一 个 动作 ， 以 处 理 针对 /home 的 GET 请 求 ， 如 下 
所 示 : 


package com.example.placereviewer.controller 


import com.example.placereviewer.service.ReviewService 
import org.springframework.stereotype.Controller 

import org.springframework.ui.Model 

import org.springframework.web.bind.annotation.GetMapping 
import java.security.Principal 

import javax.servlet.http.HttpServletRequest 


GController 
class ApplicationController(val reviewService: ReviewService) ( 


@GetMapping ("/register") 
fun register(): String { 
return "register" 


} 


@GetMapping ("/home") 
fun home (request: HttpServletRequest, model: Model, 
principal: Principal): String { 
val reviews = reviewService.listReviews() 


model.addAttribute ("reviews", reviews) 
model.addAttribute("principal", principal) 


return "home" 


} 


home 动作 检索 存储 于 数据 库 中 的 评论 列表 。 除 此 之 外 ，home 动作 设置 了 一 个 模型 属 
性 ， 用 于 加 载 包含 当前 登录 用 户 的 信息 主体 结构 。 最 后 ，home 动作 向 用 户 显示 主页 内 容 。 

在 完成 了 必要 的 准备 工作 后 , 下 面 在 Place Reviewer 平台 上 注册 用 户 , 构建 并 运行 应 
用 程序 ， 并 从 浏览 器 Chttp://localhost:5000/register) 中 访问 注册 页 面 。 首 先 ， 可 输入 并 提 
交 无 效 表单 数据 ， 进 而 执行 表单 的 验证 工作 ， 如 图 10.1 所 示 。 
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Create an account 


k 
king.k@gmail.com 


Username must be at least 6 characters in length 
Sign Up! 


图 10.1 执行 表单 的 验证 工作 
不 难 发 现 ， 错 误 被 UserValidator 检测 到 ， 并 成 功 地 绑 定 至 BindingResult， 随 后 作为 
错误 信息 在 视图 中 予以 显示 。 读 者 可 针对 表单 尝试 输入 其 他 无 效 数据 ， 以 确保 验证 行为 
的 准确 性 。 下 面 验证 注册 逻辑 方面 的 工作 。 分 别 在 用 户 名 、 电 子 邮 件 、 密 码 文本 框 中 输 
入 king.kevin, king.k@gmail.com 以 及 Kingsman406， 并 于 随后 单 击 “Sign Up!” 按 钮 。 


此 时 将 生成 一 个 新 的 账号 ， 并 显示 主页 画面 ， 如 图 10.2 所 示 。 
o | i 


€ G | © localhost:8080/home 
"You have been successfully registered and are now in your home page. 
图 10.2 生成 一 个 新 的 账号 ， 并 显示 主页 画面 


当然 ， 后 续 内 容 还 将 对 主页 进行 适当 调整 ， 现 在 让 我 们 将 注意 力 转向 创 妈 


Hoo 


F 
Dp 
E 


的 用 户 登 录 页 面 。 


10.1.2 ”实现 登录 视图 
围绕 视图 模板 展开 工作 。 登 录 视 图 所 需 


类 似 于 实现 用 户 注册 视图 ， 当 前 ， 首 先 需要 
的 模板 应 包含 一 个 表单 ， 并 作为 输入 内 容 接 收 登录 用 户 的 用 户 名 和 密码 。 除 此 之 外 ， 还 
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需 设置 一 个 按钮 ， 以 实现 登录 表单 的 提交 操作 一 一 毕竟 ， 若 无 法 提交 ， 表 单 将 变 得 毫 无 
意义 。 此 外 ， 如 果 登 录 过 程 出 现 错误 ， 还 应 存在 某 种 方式 对 用 户 予 以 提示 。 例 如 ， 用 户 
输入 了 无 效 的 用 户 名 和 密码 组 合 。 最 后 ， 对 于 未 持 有 账号 的 登录 页 面 访客 ， 还 应 提供 一 
个 账号 注册 页 面 链接 。 

在 制定 了 模板 所 需 的 各 种 条 件 后 ， 下 面 开 始 创建 模板 。 对 此 ， 将 login.html 文件 添加 
至 template 目录 中 。 一 如 既往 ， 首 先 需 要 向 模板 中 加 入 所 需 的 样式 表 和 脚本 ， 如 下 所 示 : 


<!DOCTYPE html» 
<html lang="en" xmlns:th="http://www.thymeleaf.org"> 
<head> 
<title>Login</title> 
<link rel="stylesheet" th:href="@{/css/app.css}"/> 


<link rel="stylesheet" 
href="/webjars/bootstrap/4.0.0-beta.3/css/bootstrap.min.css"/> 


<script src="/webjars/jquery/3.2.1/jquery.min.js"></script> 
<script src="/webjars/bootstrap/4.0.0-beta.3/ 
js/bootstrap.min.js"></script> 
</head> 
<body> 
</body> 
</html> 
在 加 入 了 模板 所 需 的 样式 和 JavaScript 脚本 后 ， 下 面 考察 模板 的 <body>。 如 前 所 述 ， 
当 载 入 页 面 时 , HTML 模板 的 <body> 包 含 了 DOM 元 素 , 并 向 用 户 了 予以 显示 。 在 login.html 


的 <body> 标 签 中 ， 添 加 下 列 代码 : 


<div th:insert="fragments/navbar :: navbar"></div> 


<div class="container-fluid" style="z-index: 2; position: absolute"> 
<div class-"row mt-5"» 
<div class-"col-sm-4 col-xs-2"»«/div» 
<div class-"col-sm-4 col-xs-8"» 
<form class-"form-group col-sm-12 form-vertical form-app" 
id-"form-login" method="post" th:action="@{/login}"> 
<div class-"col-sm-12 mt-2 lead text-center text-primary"» 
Login to your account 
</div> 


<hr> 
<input class-"form-control" type="text" name-"username" 
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placeholder-"Username" required/» 
<input class-"form-control mt-2" type="password" 
name-"password" placeholder-"Password" required/» 
<span th:if-"$(param.error]" class-"mt-2 text-danger" 
style-"font-size: 10px"> 
Invalid username and password combination 
</span> 
<button class-"btn btn-primary form-control mt-2 mb-3" 
type="submit"> 
Go! 
</button> 
</form> 
<div class-"col-sm-12 text-center" style-"font-size: 12px"> 
Don't an account? Register «a href="/register">here</a> 
«/div» 
«/div» 
<div class-"col-sm-4 col-xs-2"» 
<div th:if="${param.logout}" 
class="col-sm-12 text-success text-right"> 
You have been logged out. 
</div> 
</div> 
</div> 
</div> 


在 <body> 添 加 完毕 后 ， 所 创建 的 HTML 页 面 依然 可 以 描述 登录 页 面 所 需 的 结构 。 除 
了 加 入 所 需 的 表单 之 外 ， 我 们 还 向 页 面 中 添加 了 之 前 创建 的 导航 栏 片段 一 一 些 处 无 须 编 
写 样板 代码 。 此 外 ， 若 在 登录 过 程 中 出 现 错误 ， 用 户 还 可 提供 与 此 相关 的 反馈 方式 。 对 
应 代码 如 下 所 示 : 


<span th:if="${param.error}" class-"mt-2 text-danger" 
style-"font-size: 10px"> 

Invalid username and password combination 
</span> 


4; param.error 被 设置 , 则 表明 用 户 登 录 过 程 中 出 现 错 误 ， 同 时 会 向 用 户 显示 “Invalid 
username and password combination ”消息 。 需 要 注意 的 是 ， 登 录 页 面 一 般 是 用 户 与 Web 
应 用 程序 的 首 个 接触 点 ， 同 时 也 是 交互 会 话 过 程 中 的 最 后 一 个 交互 点 ， 例 如 用 户 的 注销 
操作 。 在 用 户 与 应 用 程序 交互 完毕 并 注销 时 ， 应 被 重 定 向 至 登录 页 面 。 对 此 ， 可 添加 一 
些 文本 信息 ， 以 提示 用 户 已 退出 当前 账号 ， 如 下 所 示 : 
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<div th:if="${param.logout}" class-"col-sm-12 text-success text-right"» 
You have been logged out. 
«/div» 
在 成 功 从 当前 账号 注销 后 ， 将 向 用 户 显示 <div> 标 签 。 此 时 ， 理 想 状 态 下 应 实现 一 个 
控制 器 并 显示 login.html. 但 不 要 忘记 , 我 们 已 通过 MvcConfig 且 利 用 自 定义 Spring MVC 
配置 实现 了 这 一 项 内 容 ， 如 下 所 示 : 


override fun addViewControllers(registry: ViewControllerRegistry?) { 
registry?.addViewController ("/login")?.setViewName ("login") 


} 


此 处 利用 ViewControllerRegistry 实例 添加 了 一 个 视图 控制 器 ， 处 理 /login 的 请 求 ， 并 
将 所 用 视图 设置 为 刚刚 实现 的 登录 模板 。 构 建 并 运行 应 用 程序 ， 并 查看 最 新 生成 的 视图 。 
Web 页 面 可 通过 http:localhost:5000/login 进行 访问 ， 如 图 10.3 所 示 。 


Login to your account 


Username 
Password 


Go! 


Don't an account? Register here 


图 10.3 最 新 生成 的 视图 
当 输入 无 效 的 用 户 信息 后 ， 将 会 显示 错误 消息 ， 如 图 10.4 所 示 。 
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Login to your account 


Username 


Password 


Invalid username and password combination 


Go! 


Don't an account? Register here. 


图 10.4 无 效 输入 信息 验证 
另外 一 方面 ， 在 输入 了 有 效 信息 后 ， 用 户 将 被 转 至 应 用 程序 的 主页 。 对 于 主页 ， 我 
们 需要 完善 其 视图 层 ， 并 自 此 开始 与 Google Places API 协同 工作 。 因 此 ， 在 执行 后 续 处 
理 之 前 ， 需 要 对 应 用 程序 进行 配置 。 


10.1.3 Google Places API Web 服务 


Google Places API 的 配置 过 程 十 分 简单 ， 仅 涉及 以 下 两 个 步骤 。 
(1) 获取 API 密 钥 。 
(2) 将 Google Places API 添加 至 Web 应 用 程序 中 。 
1. 获取 API 4A 
读者 可 访问 https://developers.google.com/places/web-service/get-api-key, 定位 至 Get an 
API key 部 分 ， 并 单 击 GET A KEY 按钮 ， 如 图 10.5 所 示 。 
随后 将 显示 相关 模 态 框 ， 读 者 可 以 此 选取 或 创建 与 Google Places API Web 服务 集成 
的 项 目 。 单 击 下 拉 菜 单 并 选择 Create a new project。 此 时 ， 读 者 将 被 提示 输入 项 目 名 称 ， 
此 处 可 输入 Place Reviewer 作为 项 目 名 称 ， 如 图 10.6 所 示 。 
在 输入 了 项 目 名 称 后 ， 单 击 NEXT 按钮 执行 后 续 操作 。 随 后 ， 当 前 项 目 将 通过 API 
予以 设置 ， 同 时 还 将 显示 所 用 的 API 密 钥 ， 如 图 10.7 所 示 。 
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Get an API key Contents 
Get an API key 
If you are using the standard Google Places AP! Web Service Haier i 
Places API Web 
To get started using the Google Places API Web Service, click the button below, which guides you Service 
through the process of activating the Google Places AP! Web Service and getting an API key. M you have purchased 


the Google Maps APIs 
Premium Plan 


SET Types of API key 
restrictions 


Developers Guide 
Introduction 

Get a Key 

Place Search 
Place Detais 


Place Photos 
Place Autocomplete 


Query Autocomplete Alternatively, follow these steps to get an API key: ‘Specify a key in your 
Client Libraries request 
1. Go to the Google API Console. Umi IP addresses 


Overviews 2 Create or select a project. 


3, Click Continue to enable the API 
4. On the Credentials page, get an API key (and set the API key restrictions). 
Policies and Terms Note: If you have an existing unrestricted API key, or a key with server restrictions, you may use 
Usage Lt and Biting that key. 
Places API Policies 
Terms of Service 


Place IDs 
Place Types. 


5 To prevent quota theft, secure your API key following these best practices. 


6 (Optional) Enable billing. See Usage Limits and Billing for more information. 


Do not use this key outside of your server code. For example, do not embed it in a web page or in a 
mobile application. 


t. Note: The Google Places API Web Service does not work with an Android or IOS restricted API key. 


图 10.5 获取 API 2:4] 


Enable Google Maps JavaScript API 


Place Reviewer, 


图 10.6 输入 Place Reviewer 作为 项 目 名 称 
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You're all set! 


You're ready to start developing with Google Places API Web Service. 


È Tomoe yor pps cayn 


图 10.7 项 目 设置 完毕 并 显示 API 8:9] 
ERA API 密 钥 后 ， 下 面 考察 如 何 使 用 API 密 钥 。 
2. 在 Web 应 用 程序 中 设置 Google Places 
对 于 Google Places API Web 服务 ，API 的 应 用 十 分 简单 ， 且 与 生成 API 密 钥 十 分 相 
似 。 当 在 Web 应 用 程序 中 使 用 生成 的 API 密 钥 时 ， 仅 需 在 使 用 Web 服务 的 页 面 标记 中 
包含 以 下 HTML 代码 : 
<script type-"text/javascript" 


src-"https://maps.googleapis.com/maps/api/js?key-((API KEY))&libraries-plac 
es"></script> 


其 中 ， 确 保利 用 所 生成 的 API 2:5] PR { {APL KEY}}. 
10.14 实现 主 视 图 


在 开始 编写 代码 之 前 ， 可 针对 所 创建 的 视图 设置 一 个 粗略 的 图 形 化 模型 。 从 长 远 来 
看 ， 这 将 为 构建 过 程 提供 一 个 清晰 的 方向 ， 从 而 节省 大 量 的 时 间 。 

主页 的 创建 过 程 涉及 以 下 几 个 步骤 : 

(1) 显示 最 新 的 地 点 评论 。 

(2) 可 直接 访问 发 表 评 论 的 Web 页 面 。 
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G) 提供 一 种 方式 ， 用 户 可 退出 当前 账号 。 
(4) 借助 于 地 图 ， 用 户 可 查看 评论 地 点 的 准确 位 置 。 
综 上 所 述 ， 图 10.8 显示 了 最 终 模板 的 粗略 示意 图 。 


Review Review Review Review 


图 10.8 ”最 终 模板 的 示意 图 


图 10.8 中 的 各 项 内 容 实现 起 来 并 不 复杂 。 单 击 View location 将 显示 应 用 程序 用 户 ， 
其 间 ， 地 图 将 显示 评论 地 点 的 准确 位 置 。 

在 明晰 了 即将 创建 的 模板 后 ， 下 面 开 始 对 其 进行 编码 。 与 以 往 一 样 ， 首 先 需要 向 模 
板 中 加 入 外 部 样式 表 和 脚本 。 打 开 home.html 文件 并 添加 下 列 代码 : 


<!DOCTYPE html» 
<html lang="en" xmlns:th="http://www.thymeleaf.org"> 
<head> 
<title>Home</title> 
<!-- Addition of external stylesheets --> 
<link rel="stylesheet" th:href="@{/css/app.css}"/> 
<link rel="stylesheet" 
href="https://cdnjs.cloudflare.com/ajax/libs/toastr.js 
/latest/toastr.min.css"> 

<link rel="stylesheet" 
href-"/webjars/bootstrap/4.0.0-beta.3/css/bootstrap.min.css"/» 
<link rel="stylesheet" 
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href-"https://maxcdn.bootstrapcdn.com/font-awesome 
/4.7.0/css/font-awesome.min.css"/> 
<link href="https://fastcdn.org/Buttons/2.0.0/css/buttons.css" 
rel="stylesheet"> 


<!-- Inclusion of external Javascript --> 

"/webjars/jquery/3.2.1/jquery.min.js"></script> 

<script src="https://cdnjs.cloudflare.com/ajax/libs 
/toastr.js/latest/toastr.min.js"> 


<script src 


</script> 

<script src="https://cdnjs.cloudflare.com/ajax/libs 
/popper.js/1.12.6/umd/popper.min.js"> 

</script> 

<script src-"/webjars/bootstrap/4.0.0-beta.3/ 
js/bootstrap.min.js"></script> 

<script src="https://fastcdn.org/Buttons/2.0.0/js/buttons.js"></script> 

<script type="text/javascript" 

src="https://maps.googleapis.com/maps/api/js?key={ {API_KEY}} 

&libraries-places"» 
</head> 
</html> 


除了 外 部 样式 表 之 外 ， 还 将 使 用 到 模板 中 的 内 部 样式 。 当 在 HTML 文件 中 定义 内 部 
样式 表 时 ， 可 在 HIML 头 中 简单 地 添加 <sstyle>， 并 输入 所 期 望 的 CSS 规则 即 可 。 接 下 
来 ， 可 向 home.html 中 添加 下 列 样式 : 


</script> 


<!-- Definition of internal styles --> 
<style> 
#map { 
height: 400px; 
} 


-container-review { 
background-color: white; 
border-radius: 2px; 
font-family:sans-serif; 
box-shadow: 0 0 1px black; 
border-color: black; 
padding: 0; 
min-width: 250px; 
height: 230px; 
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-review-author { 
font-size: 15px 


.review-location ( 
font-size: 12px 


j 


.review-title ( 
font-size: 13px; 
text-decoration-style: dotted; 
height: calc(20 / 100 * 230px); 
) 


.review-content { 

font-size: 12px; 

height: calc(40 / 100 * 230px); 
) 


.review-header { 
height: calc(20 / 100 * 230px) 
} 


DETI 
margin: 0; 


} 


.review-footer { 
height: calc(20 / 100 * 230px); 
} 
</style> 


下 面 考察 页 面 的 主体 内 容 。 读 者 已 经 了 解 到 ， 构 成 HTML 模板 主体 的 所 有 元 素 须 位 
于 <body> 标 签 内 。 相 应 地 ， 可 向 模板 文件 中 添加 下 列 HTML 代码 : 


<!-- Invokes the showNoReviewNotification() function defined in --> 
«!-- internal Javascript of this file upon document load. --> 
«body 


th:onload-"'javascript:showNoReviewNotification( 
' + ${reviews.size() == 0) + ' 
LES 
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<div th:insert="fragments/navbar :: navbar"></div> 
<div class="container"> 
<div class="row mt-5"> 


<!-- Creates view containers for each review retrieved --> 
<!-- Distinct <div> containers are created for the --> 
<!-- review author, location, title and body. --> 


<div th:each-"review: ${reviews}" 
class-"col-sm-2 container-review mt-4 mr-2"» 
<div class-"review-header pt-1"> 
<div class="col-sm-12 review-author text-success"> 
<b th:text="${review.reviewer.username}"></b> 
</div> 
<div th:text="${review.placeName}" 
class-"col-sm-12 review-location"> 
</div> 
</div> 
<hr> 
<b> 
<div th:text="${review.title}" 
class-"col-sm-12 review-title pt-1"> 
«/div» 
</b> 
<hr> 
<div th:text="${review.body}" 
class-"col-sm-12 review-content pt-2"> 
«/div» 
<div class="review-footer"> 
<!-- Creation of distinct DOM 
<button> elements for the display of reviewed locations. --> 
<!-- Upon button click, the application renders a modal 
showing the reviewed location on a map --> 
<button class="col-sm-12 button button-small button-primary" 
type="button" data-toggle="modal" data-target="#mapModal" 
style="height: inherit; border-radius: 2px;" 
th:onclick-"'javascript:showLocation( 
' + ${review.latitude} + ',' 
+ ${review.longitude} + ',V'' 
+ ${review.placeId} + '\' 
yr 
<i class="fa fa-map-o" aria-hidden="true"></i> 
View location 
</button> 
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</div> 
</div> 
</div> 
</div> 


读者 不 必 为 代码 块 的 具体 功能 而 担心 ， 稍 后 将 会 逐一 加 以 解释 。 下 面 继续 向 
home.html 中 添加 下 列 代 码 : 


«!-- Modal creation --» 
<div class-"modal fade" id="mapModal"> 
<div class-"modal-dialog modal-lg" role="document"> 
<div class="modal-content"> 
<div class="modal-header"> 
<h5 class="modal-title">Reviewed location</h5> 
<button type="button" class="close" 
data-dismiss="modal" aria-label="Close"> 
<span aria-hidden="true">&times; </span> 
</button> 
</div> 
<div class="modal-body"> 
<div class="container-fluid"> 
<div id="map"> </div> 
</div> 
</div> 
<div class="modal-footer"> 
<button type-"button" class-"btn btn-primary" 
data-dismiss="modal"> 
Done 
</button> 
</div> 
</div> 
</div> 
</div> 


上 述 代码 声明 了 一 种 模 态 框 ， 用 于 加 载 显示 评论 地 址 的 地 图 ， 稍 后 将 对 此 予以 实现 。 
下 面 继续 讨论 <body>， 并 添加 下 列 代码 。 


<span style="bottom: 20px; right: 20px; position: fixed"> 
<form method="get" th:action="@{/create-review}"> 
<button class="button button-primary button-circle 
button-giant navbar-bottom" type="submit"> 
Xi class="fa fa-plus"></i> 
</button> 
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«/form» 
</span> 


最 后 ， 还 需 针 对 HTML 页 加 入 内 部 JavaScript， 如 下 所 示 : 


<script> 
//Shows a toast notification to the user when no review is present 
function showNoReviewNotification (show) { 
if (show) { 
toastr.info('No reviews to see'); 


} 
下 列 函 数 初 始 化 并 显示 地 图 ， 进 而 显示 评论 的 地 理 位 置 。 


function showLocation(latitude, longitude, placeId) { 
var center - new google.maps.LatLng(latitude, longitude); 


var map = new google.maps.Map(document.getElementById('map'), { 
center: center, 
zoom: 15, 
scrollwheel: false 

)n; 


var service - new google.maps.places.PlacesService (map); 


loadPlaceMarker(service, map, placeId); 


} 
加 载 位 置 标记 将 在 评论 地 址 上 创建 地 图 标记 ， 如 下 所 示 : 


function loadPlaceMarker(service, map, placeId) { 
var request = { 
placeld: placeld 
he 


service.getDetails(request, function (place, status) { 
if (status google.maps.places.PlacesServiceStatus.OK) { 
new google.maps.Marker ({ 
map: map, 


title: place-name, 

place: { 
placelId: place.place id, 
location: place.geometry.location 


} 
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} 
ye 
} 
</script> 
</body> 
下 面 从 <head> 标 签 开 始 ， 并 着 手 实现 视图 方面 的 内 容 。 之 前 曾 添加 了 主页 所 需 的 样 


式 表 和 脚本 ， 下 列 代码 添加 了 CSS 方面 的 内 容 。 


<link rel="stylesheet" th:href="@{/css/app.css}"/> 

<link rel="stylesheet" 
href-"https://cdnjs.cloudflare.com/ajax/libs/toastr.js/latest/toastr. 
min.css"> 
<link rel="stylesheet" href="/webjars/bootstrap/4.0.0- 
beta.3/css/bootstrap.min.css"/> 

<link rel="stylesheet" 
href-"https://maxcdn.bootstrapcdn.com/font-awesome/4.7.0/css/font-awesome. 
min.css"/» 

<link href="https://fastcdn.org/Buttons/2.0.0/css/buttons.css" 
rel="stylesheet"> 


上 述 代码 针对 应 用 程序 的 CSS 加 入 了 外 部 样式 表 。 其 中 ,Toastr 库 用 于 生成 JavaScript 
通知 消息 ， Bootstrap 库 在 设置 站 点 和 Web 应 用 程序 方面 表现 得 十 分 强大 ; Font Awesome 
则 是 针对 站 点 和 Web 应 用 程序 的 图 标 工具 ; Buttons 则 是 一 个 高 度 自 定义 Web 和 CSS 按 
钮 库 。 

在 包含 了 CSS 后 ， 还 需要 设置 一 些 外 部 JavaScript 方面 的 内 容 ， 如 下 所 示 : 


<script src="/webjars/jquery/3.2.1/jquery.min.js"></script> 

<script 
src-"https://cdnjs.cloudflare.com/ajax/libs/toastr.js/latest/toastr.min.js" 
></script> 

<script 
src-"https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.12.6/umd/popper.min 
=JS"></seript> 

<script src="/webjars/bootstrap/4.0.0-beta.3/js/bootstrap.min.js"> 


</script> 

<script src="https://fastcdn.org/Buttons/2.0.0/js/buttons.js"></script> 
<script type-"text/javascript" 
src="https://maps.googleapis.com/maps/api/js?key={{API KEY}}&libraries 
=places"></script> 


上 述 脚 本 所 包含 的 顺序 依次 为 : JQuery, 针对 简化 客户 端 脚 本 处 理 而 设计 的 JavaScript 
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Æ; Toastr 和 Popper， 用 于 管理 Web 应 用 程序 弹出 消息 的 库 ， 随后 是 Bootstrap、Buttons 
和 Google Places API Web 服务 。 再 次 强调 ， 对 于 Google Places API Web 服务 ， 需 要 利用 
API 密 钥 蔡 换 {{API KEY}}， 这 一 点 十 分 重要 。 

JavaScript 之 后 ， 我 们 将 针对 定义 内 部 样式 表 。 然 而 ， 样 式 表 及 其 创建 过 程 的 讨论 超 
出 了 本 书 的 范围 ， 读 者 可 回顾 CSS 方面 的 内 容 。 对 于 home.html， 下 面 添加 <body>: 

<body th:onload-"'javascript:showNoReviewNotification(' + 

${reviews.size()== 0) + ')'"> 

其 中 , th:onload 用 于 指定 页 面 完 全 加 载 后 需要 运行 的 JavaScript, BD ^E onload 事件 
后 所 需 执 行 的 代码 。 此 处 ， 所 运行 的 脚本 为 模板 中 定义 的 JavaScript 函数 
showNoReviewNotification(boolean)。 若 模型 提供 的 评论 列表 为 空 ， 该 函数 则 显示 相关 消 
息 ， 表 明 当 前 不 存在 可 查看 的 评论 内 容 。showNoReviewNotification(boolean) 在 模板 中 的 
声明 如 下 所 示 : 

function showNoReviewNotification(show) ( 

if (show) ( 
toastr.info('No reviews to see'); 


} 
} 


showNoReviewNotification(boolean) 函 数 接收 单一 参数 show. #7 show 为 true, Toastr 
库 将 向 用 户 显 示 通 知 消息 。 
对 于 可 显示 的 评论 内 容 ， 则 针对 每 条 评论 创建 一 个 容器 ， 如 下 所 示 : 


<!-- Creates view containers for each review retrieved --> 

<!-- Distinct <div> containers are created for the --> 

<!-- review author, location, title and body. --> 

<div th:each-"review: ${reviews}" class-"col-sm-2 container-review mt-4 
mr-2"» 


<div class-"review-header pt-1"> 
<div class-"col-sm-12 review-author text-success"» 
<b th:text="${review.reviewer.username}"></b> 
</div> 
<div th: text="${review.placeName}" class-"col-sm-12 review-location"> 
</div> 
</div> 
<hr> 
<b> 
<div th:text="${review.title}" class-"col-sm-12 review-title pt-1"> 
</div> 
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</b> 
<hr> 
<div th:text="${review.body}" class-"col-sm-12 review-content pt-2"» 
«/div» 
<div class="review-footer"> 
<!-- Creation of distinct DOM «button» elements for the 
display of reviewed locations. --» 
<!-- Upon button click, the application renders a modal 


showing the reviewed location on a map --> 
<button class="col-sm-12 button button-small button-primary" 
type-"button" data-toggle-"modal" data-target="#mapModal" 
style-"height: inherit; border-radius: 2px;" 
th:onclick-"'javascript:showLocation(" 
+ ${review.latitude} + ',' 
+ ${review.longitude} + ',V'" 
+ ${review.placeId} + '\ 
n> 
<i class="fa fa-map-o" aria-hidden="true"></i> 
View location 
</button> 
</div> 
</div> 


每 个 评论 容器 将 显示 评论 者 的 用 户 名 、 评 论 地 址 名 称 、 评 论 标题 、 评 论 内 容 ， 以 及 
可 供用 户 查 看 评论 位 置 的 按钮 。 这 里 ，Thymeleaf 的 th:each 用 于 遍历 reviews 列表 中 的 每 
条 评论 。 如 下 所 示 : 

<div th:each="review: ${reviews}" class="col-sm-2 container-review mt-4 

mr-2"» 

当 理 解 遍历 处 理 过 程 时 ， 一 种 较 好 的 方法 是 将 th:each="review:$ {reviews}" 读 作 “For 
each review in reviews”。 此 处 ， 当 前 所 遍历 的 评论 由 review 遍历 加 载 。 因 此 ， 被 遍历 的 
评论 所 持 有 的 数据 可 像 其 他 对 象 那样 予以 访问 ， 如 下 所 示 : 

<div th:text="${review.placeName}" class-"col-sm-12 review-location"> 

</div> 

其 中 ，th:text 负责 将 <div> 持 有 的 文本 设置 为 review.placeName 的 赋值 结果 。 另 外 ， 
这 里 有 必要 解释 一 下 位 置地 图 相对 于 用 户 的 显示 方式 。 考 察 下 列 代 码 : 

<button class-"col-sm-12 button button-small button-primary" type-"button" 


data-toggle-"modal" data-target="#mapModal" style="height: inherit; 


border-radius: 2px;" 
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th:onclick-"'javascript:showLocation(" 

+ ${review.latitude} + ',' 
+ ${review.longitude} + ',\"' 
+ ${review.placeId} + '\ 
rym 
<i class="fa fa-map-o" aria-hidden-"true"»«/i» 
View location 

</button> 


上 述 代码 块 定义 了 一 个 按钮 ， 并 在 产生 单 击 事件 时 执行 两 项 任务 。 首 先 向 用 户 显示 
ID mapModal 标识 的 模 态 框 ， 其 次 将 初始 化 并 显示 地 图 ， 进 而 显示 评论 的 准确 地 理 位 置 。 
其 中 ， 地 图 的 显示 过 程 可 通过 定义 于 模板 文件 中 的 showLocation() JavaScript 函数 完成 。 
showLocation0 函 数 接收 3 个 参数 。 第 一 个 参数 表示 经 度 坐 标 ， 第 二 个 参数 表示 维度 
坐标 ， 第 三 个 参数 表示 评论 地 理 位 置 的 唯一 标识 符 ， 即 位 置 ID。 地 理 位 置 的 位 置 ID 可 
通过 Google Places API 获得 。 首 先 ，showLocation0 检 索 地 理 位 置 坐标 的 中 心 点 一 一 可 使 
用 Google Places API 中 的 google.maps.LatLng 类 。 简单 地 讲 , LatLng 表示 地 理 坐 标点 ( 精 
度 和 维度 ) 。 当 检索 到 中 心 点 后 ， 新 地 图 将 通过 Map 2$ (H Google Places API 提供 ) 创 
建 ， 如 下 所 示 : 
var map = new google.maps.Map(document.getElementById('map'), { 
center: center, 
zoom: 15, 
scrollwheel: false 
Ds 
生成 后 的 地 图 将 置 于 包含 ID map 的 DOM 容器 元 素 中 。 在 地 图 构建 完毕 后 ， 可 借助 
于 loadPlaceMarker() 函数 在 准确 位 置 处 生成 位 置 标记 。loadPlaceMarkerO 函数 接收 
google.maps.places.PlacesService、Map 以 及 一 个 位 置 ID 作为 其 参数 。 其 中 ,PlacesService 
类 包含 了 检索 位 置信 息 和 搜索 位 置 的 相关 方法 。 
google.maps.places.PlacesService 实例 首先 用 于 检索 包含 特定 位 置 ID 〈 评 论 的 地 理 位 置 ) 
的 位 置信 息 。 如 果 位 置信 息 被 成 功 检 索 ，status —google.maps.places.PlacesServiceStatus.OK 
的 计算 结果 为 tue, 位 置 标记 将 置 于 当前 地 图 上 .。 相应 地 , 该 标记 通过 google.maps.Marker 
类 予以 创建 。Marker0 接 收 一 个 可 选 的 Options 对 象 作为 其 唯一 参数 。 若 存在 该 对 象 ， 那 
么 ， 位 置 标记 将 通过 特定 的 可 选项 予以 创建 。 此 时 ， 地 图 定义 于 Options 对 象 中 。 因 此 ， 
标记 在 生成 后 即 添加 至 地 图 中 。 
最 后 , 我 们 还 向 模板 中 添加 了 一 个 表单 , 并 在 提交 后 发 送 /reviews/new 路 径 上 的 GET 
请 求 。 此 外 ， 还 设置 了 一 个 按钮 一 一 单 击 该 按钮 将 提交 表单 。 对 应 代码 如 下 所 示 : 
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<form method-"get" th:action="@{/reviews/new}"> 
<button class="button button-primary button-circle button-giant 
navbar-bottom" type="submit"><i class="fa fa-plus"></i></button> 
</form> 


至 此 ， 主 页 设计 暂 告 一 段落 。 读 者 可 尝试 重新 构建 并 运行 应 用 程序 、 注 册 账 号 并 查 
看 如 图 10.9 所 示 的 主页 画面 。 


Q Noreviewsto se: 


图 10.9 主页 画面 显示 效果 


评论 内 容 。 
10.1.5 生成 评论 


截至 目前 ， 前 述 内 容 构建 了 用 户 注册 视图 、 登 录 视 图 ， 以 及 登录 用 户主 页 ， 以 查看 
所 发 表 的 评论 内 容 。 下 面 考察 与 发 表 评论 相关 的 视图 。 像 以 往 一 样 ， 在 创建 视图 之 前 ， 
首先 定义 相关 动作 , 以 向 用 户 显示 相关 视图 。 在 Application Controller 类 中 添加 下 列 代码 : 
GGetMapping ("/create-review") 
fun createReview (model: Model, principal: Principal): String { 
model.addAttribute "principal", principal) 
return "create-review" 
) 
通过 向 客户 端 返回 create-review.html 模板 ，createReview0) 动 作 处 理 /create-review 路 
径 的 HITP GET 请 求 。 下 面向 项 目 template 目录 中 添加 create-review.html 文件 。 
同样 ， 需 要 向 createreview.html 中 添加 外 部 样式 和 脚本 ， 如 下 所 示 : 


<!DOCTYPE html» 
<html lang-"en" xmlns:th="http://www.thymeleaf.org"> 
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<head> 
<title>New review</title> 
<!-- Addition of external stylesheets --> 
<link rel="stylesheet" th:href="@{/css/app.css}"/> 
<link rel="stylesheet" href-"/webjars/bootstrap/4.0.0-beta.3 
/css/bootstrap.min.css"/> 
<link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com 
/font-awesome/4.7.0/css/font-awesome.min.css"/» 
<link href-"https://fastcdn.org/Buttons/2.0.0/css/buttons.css" 
rel-"stylesheet"» 


<!-- Inclusion of external Javascript --> 

<script src="/webjars/jquery/3.2.1/jquery.min.js"></script> 

<script src-"https://cdnjs.cloudflare.com/ajax/libs/popper.js 

/1.12.6/umd/popper .min.js"></script> 

<script src-"/webjars/bootstrap/4.0.0-beta.3/ 
js/bootstrap.min.js"></script> 

<script src="https://fastcdn.org/Buttons/2.0.0/js/buttons.js"> </script> 

<script type-"text/javascript" src="https://maps.googleapis.com/ 

maps/api/js?key={{API KEY}}&libraries=places"> 


</script> 
下 列 代码 针对 Web 页 面 添 加 了 所 需 的 内 部 样式 表 。 
«!-- Definition of internal styles --> 
«style» 
#map { 


height: 400px; 
} 


#container-place-data { 
height: 0; 
visibility: hidden; 

} 


#container-place-info { 
font-size: 14px; 


#container-selection-status { 
visibility: hidden; 
} 
</style> 
</head> 
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接 下 来 需要 构建 表单 ， 用 于 评论 数据 的 输入 。 在 create-review.html 模板 中 添加 下 列 
代码 : 


<body> 
<div th:insert-"fragments/navbar :: navbar"> </div> 
<div class-"container-fluid"» 
<div class="row"> 
<div class-"col-sm-12 col-xs-12"» 
<!-- Review form creation --» 
<form class-"form-group col-sm-12 form-vertical form-app" 
id="form-login" method="post" th:action="@{/reviews}"> 
<div class="col-sm-12 mt-2 lead">Write your review</div> 


<div th:if="${error != null}" class="text-danger" 
th:text="${error}"> </div> 
<hr> 


<input class="form-control" type="text" name-"title" 
placeholder-"Title" th:value="${title}" required/> 
<textarea class-"form-control mt-4" rows="13" name="body" 
placeholder="Review" th:value="${body}" required></textarea> 
<div class="form-group" id="container-place-data"> 
<!-- Input fields for location specific form data --> 
<!-- Form input data for the fields below are 
provided by the Google Places API --> 
<input class="form-control" id="place address" 
th: value="${placeAddress}" type="text" name-"placeAddress" 
required/> 
<input class-"form-control" id="place name" type="text" 
name-"placeName" th:value="${placeName}" required/> 
<input class-"form-control" id-"place id" type="text" 
name-"placeId" th:value="${placeId}" required/> 
<input id-"location-lat" type-"number" name-"latitude" 
step-"any" th:value="${latitude}" required/> 
<input id="location-lng" type-"number" name-"longitude" 
step="any" th:value="${longitude}" required/> 
</div> 
<div class="form-group mb-3"> 
<button class="button button-pill" type-"button" 
data-toggle="modal" data-target="#mapModal"> 
<i class="fa fa-map-marker" aria-hidden="true"></i> 
Select Location 
</button> 
<button class="button button-pill button-primary"> 
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Submit Review</button> 
«/div» 
<div class-"text-success ml-2" id="container-selection-status"> 
Location selected«/div» 
</form> 
</div> 
</div> 


下 面 添 加 模 态 框 ， 以 使 用 户 可 从 地 图 中 选择 评论 地 理 位 置 ， 代 码 如 下 所 示 : 


«!-- Map Modal --> 
<div class-"modal fade" id="mapModal"> 
<div class-"modal-dialog modal-lg" role="document"> 
<div class-"modal-content"» 
<div class="modal-header"> 
<h5 class="modal-title">Select place to review</h5> 
Xbutton type-"button" class-"close" data-dismiss-"modal" 
aria-label-"Close"» 
<span aria-hidden="true">&times; </span> 
</button> 
</div> 
<div class="modal-body"> 
<div class="container-fluid"> 
<div id="map"> </div> 
<div class="row mt-2" id="container-place-info"> 
<div class-"col-sm-12" id="container-place-name"> 
<b>Place Name:</b> 
</div> 
<div class="col-sm-12" id="container-place-address"> 
<b>Place Address:</b> 
</div> 
</div> 
</div> 
</div> 
<div class="modal-footer"> 
<button type-"button" class="btn btn-primary" 
data-dismiss="modal">Done</button> 
</div> 
</div> 
</div> 
</div> 
</div> 
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最 后 ， 还 需要 添加 内 部 JavaScript 以 完成 当前 模板 ， 代 码 如 下 所 示 : 


<script> 
// form field reference creation 
var formattedAddressField - document 
-getElementById('place address'); 
var placeNameField = document.getElementById('place name'); 
var placeIdField - document.getElementById('place id'); 
var latitudeField = document.getElementById('location-lat'); 
var longitudeField = document.getElementById('location-lng'); 


// container reference creation 

var containerPlaceName = document.getElementById 
('container-place-name'); 

var containerPlaceAddress - document.getElementById 
('container-place-address'); 

var containerSelectionStatus - document.getElementById 
('container-selection-status'); 


在 上 述 代码 片段 中 , 创建 了 指向 当前 页 面 中 DOM 元 素 的 引用 , 包括 位 置 输入 框 ( 针 
对 地 址 、 名 称 、ID 以 及 地 址 的 经 纬度 坐标 ) 。 除 此 之 外 ， 还 添加 了 指向 显示 所 选 地 址 信 
息 的 容器 的 引用 , 例如 地 址 名 称 和 地 址 。 对 此 , 需要 声明 相应 的 函数 , 其 中 包括 initializeO、 
getPlaceDetailsById(). updateViewData(). setFormValues(). showSelectionsStatusContainer() 
以 及 setContainerText(). 

接 下 来 首先 向 模板 中 加 入 initialize0 和 getPlaceDetailsById0 函 数 ， 如 下 所 示 : 


//invoked to initialize Google map 
function initialize() ( 


navigator.geolocation.getCurrentPosition(function(location) ( 
var latitude = location.coords.latitude; 
var longitude - location.coords.longitude; 


var center - new google.maps.LatLng(latitude, longitude); 


var map = new google.maps.Map(document.getElementById('map'), { 
center: center, 
zoom: 15, 
scrollwheel: false 


p: 


var service = new google.maps.places.PlacesService (map); 
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map.addListener('click', function(data) { 
getPlaceDetailsById(service, data.placeId); 
E 
E 


} 
下 列 函 数 可 通过 Google Places API 获取 特定 位 置 ， 进 而 检索 具体 的 地 理 位 置 。 


function getPlaceDetailsById(service, placeId) { 
var request = { 
placeld: placeId 
ye 


service.getDetails(request, function (place, status) { 
if (status === google.maps.places.PlacesServiceStatus.OK) { 
updateViewData (place) 


E 
} 


下 面 是 updateView() 和 setFormValues() i 2. 


//Invoked to update view information 
function updateViewData (Place) { 
setFormValues( 
place.formatted address, 
place.name, 
place.place id, 
place.geometry.location.lat(), 
place.geometry.location.1ng() 


setContainerText ('<b>Place Name: </b>' + place.name, 
"<b>Place Address: </b>' + place.formatted address); 


showSelectionStatusContainer () ; 
} 
当 调用 下 列 函数 时 ， 将 更 新 视图 表单 数据 。 


function setFormValues (formattedAddress, placeName, placeld, 
latitude, longitude) ( 
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formattedAddressField.value = formattedAddress; 
placeNameField.value = placeName; 
placeIdField.value = placeId; 
latitudeField.value - latitude; 
longitudeField.value = longitude; 

) 


最 后 ， 添 加 下 列 代码 以 完成 当前 模板 。 


function showSelectionStatusContainer() ( 
containerSelectionStatus.style.visibility = 'visible' 


} 


function setContainerText (placeNameText, placeAddressText) { 
containerPlaceName.innerHTML = placeNameText; 
containerPlaceAddress.innerHTML = placeAddressText; 
} 
// Initializes map upon window load completion 
google.maps.event.addDomListener (window, 'load', initialize); 
</script> 
</body> 
</html> 
与 上 述 模板 类 似 ，create-review.html 中 包含 了 外 部 和 内 部 CSS， 以 及 HTML<head> 
标签 中 模板 所 需 的 JavaScript。 进 一 步 讲 ， 需 要 创建 一 个 表单 ， 并 接收 下 列表 单数 据 作为 
其 输入 内 容 : 
title: 针对 所 发 表 的 评论 定义 的 用 户 标题 。 
body: 评论 内 容 ， 即 主要 的 评论 文本 。 
placeAddress: 评论 的 地 理 位 置 。 
placeName: 评论 的 地 名 。 
placeld: 评论 位 置 的 唯一 ID。 
latitude: 评论 位 置 的 经 度 坐 标 。 
longitude: 评论 位 置 的 纬度 坐标 。 
此 处 ， 无 须 针 对 用 户 提 供 placeAddress. placeName. placeld. latitud 以 及 longitude 
的 表单 输入 。 因 此 ， 可 隐藏 前 述 输入 元 素 的 父 <div>。 此 外 ， 还 需 使 用 Google Places API 
检索 位 置信 息 。 需 要 注意 的 是 ， 在 模板 中 ， 我 们 利用 模 态 框 显示 所 选 地 址 的 地 图 。 该 模 
态 框 可 通过 添加 至 模板 中 的 button 进行 切换 ， 如 下 所 示 : 
<button class="button button-pill" type="button" data-toggle-"modal" 
datatarget="#mapModal"> 


Ooooooo 
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Xi class="fa fa-map-marker" aria-hidden="true"></i> Select Location 
</button> 


单 击 按钮 将 向 用 户 显示 地 图 模 态 框 。 当 显示 地 图 时 ， 用 户 可 从 地 图 中 单 击 评论 地 点 。 
相应 地 ， 执 行 这 一 类 单 击 动作 将 触发 地 图 的 单 击 事件 ， 并 通过 定义 于 模板 中 的 监听 器 进 
行 处 理 ， 如 下 所 示 : 

map.addListener('click', function(data) { 


getPlaceDetailsById(service, data.placeId); 
]) 7 


getPlacesDetailsByIdO 函 数 接收 两 个 参数 ， 即 google.maps.places.PlacesService 实例 ， 
以 及 评论 信息 的 位 置 ID。 随 后 ，PlacesService 实例 用 于 检索 位 置信 息 。 在 获取 了 相关 信 
息 后 ， 视 图 也 据 此 进行 更 新 : 设置 特定 位 置 的 表单 数据 、 更 新 地 图 模 态 框 中 的 位 置 名 称 
和 地 址 容器 ， 并 向 用 户 显示 位 置 被 成 功 选 定 这 一 消息 。 当 位 置 选取 以 及 全 部 所 需 表 单数 
据 输 入 操作 完毕 后 ， 用 户 即 可 提交 其 评论 内 容 。 

在 查看 评论 发 表 页 面 之 前 ， 还 需 创建 一 个 评论 验证 器 以 及 一 个 控制 器 ， 以 处 理发 送 
至 /reviews 路 径 中 的 POST 请 求 。 对 此 ， 可 向 com.example.placereviewer.component 中 添 
加 ReviewValidator 类 ， 如 下 所 示 : 


package com.example.placereviewer.component 


import com.example.placereviewer.data.model.Review 
import org.springframework.stereotype.Component 
import org.springframework.validation.Errors 

import org.springframework.validation.ValidationUtils 
import org.springframework.validation.Validator 


GComponent 
class ReviewValidator: Validator { 


override fun supports(aClass: Class<*>?): Boolean { 
return Review::class == aClass 


} 


override fun validate (obj: Any?, errors: Errors) { 
val review = obj as Review 


ValidationUtils.rejectIfEmptyOrWhitespace (errors, "title", 
"Empty.reviewForm.title", "Title cannot be empty") 
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ValidationUtils.rejectIfEmptyOrWhitespace (errors, "body", 


"Empty.reviewForm.body", "Body cannot be empty") 


ValidationUtils.rejectlIfEmptyOrWhitespace (errors, "placeName", 


"Empty.reviewForm.placeName") 


ValidationUtils.rejectlIfEmptyOrWhitespace (errors, 


"placeAddress","Empty.reviewForm.placeAddress") 


ValidationUtils.rejectlIfEmptyOrWhitespace (errors, "placeId", 


"Empty.reviewForm.placeId") 


ValidationUtils.rejectlIfEmptyOrWhitespace (errors, "latitude", 


"Empty.reviewForm.latitude") 


ValidationUtils.rejectlIfEmptyOrWhitespace (errors, "longitude", 


"Empty.reviewForm.longitude") 


if (review.title.length « 5) ( 
errors.rejectValue("title", "Length.reviewForm.title", 


"Title must be at least 5 characters long") 


if (review.body.length < 5) ( 
errors.rejectValue("body", "Length.reviewForm.body", 


} 


"Body must be at least 5 characters long") 


前 述 内 容 曾 解 释 了 自 定义 验证 器 的 工作 机 制 ， 下 面 通过 代码 方式 对 此 稍 作 回顾 ， 即 
针对 与 评论 相关 的 HTTP 请 求实 现 控制 器 类 。 相 应 地 ， 在 com.example.placereviewer. 
controller 中 定义 ReviewController 类 ， 并 添加 下 列 代码 : 


package com.example.placereviewer.controller 


import 
import 
import 
import 
import 
import 
import 
import 
import 
import 


com.example.placereviewer.component.ReviewValidator 
com.example.placereviewer.data.model.Review 
com.example.placereviewer.service.ReviewService 
org.springframework.stereotype.Controller 
org.springframework.ui.Model 
org.springframework.validation.BindingResult 
org.springframework.web.bind.annotation.ModelAttribute 
org.springframework.web.bind.annotation.PostMapping 
org.springframework.web.bind.annotation.RequestMapping 
javax.servlet.http.HttpServletRequest 
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@Controller 

@RequestMapping ("/reviews") 

class ReviewController(val reviewValidator: ReviewValidator, 
val reviewService: ReviewService) { 


@PostMapping 
fun create (@ModelAttribute reviewForm: Review, bindingResult: 
BindingResult, 
model: Model, request: HttpServletRequest): String { 
reviewValidator.validate(reviewForm, bindingResult) 


if (!bindingResult.hasErrors()) { 
val res = reviewService.createReview(request.userPrincipal.name, 
reviewForm) 
if (res) { 
return "redirect: /home" 


with (model) { 
addAttribute("error", bindingResult.allErrors. first () .defaultMessage) 
addAttribute("title", reviewForm.title) 
addAttribute("body", reviewForm.body) 
addAttribute("placeName", reviewForm.placeName) 
addAttribute("placeAddress", reviewForm.placeAddress) 
addAttribute("placeId", reviewForm.placeId) 
addAttribute("longitude", reviewForm. longitude) 
addAttribute("latitude", reviewForm. latitude) 


return "create-review" 


} 


在 定义 了 ReviewValidator 和 ReviewController 类 之 后 ， 构 建 并 运行 当前 项 目 ， 执 行 
用 户 登 录 操 作 ， 并 从 浏览 器 中 访问 http://localhost:5000/create-review。 

页 面 加 载 完 毕 后 ， 将 显示 一 个 表单 ， 用 户 可 于 其 中 添加 新 的 评论 内 容 ， 如 图 10.10 
所 示 。 

用 户 需 要 在 提交 评论 之 前 选取 评论 地 理 位 置 。 对 此 ， 可 单 击 Select Location 按钮 ， 如 
图 10.11 所 示 。 
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Write your review 


Title 


Review 


9 Select Location 


图 10.10 发 表 评 论 内 容 


Select place to review 
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图 10.11 选取 地 理 位 置 
单 击 Select Location 按钮 将 向 用 户 显示 一 个 模 态 框 , 其 中 包含 了 选取 评论 地 理 位 置 的 
地 图 。 从 地 图 上 单 击 某 个 位 置 将 显示 地 图 上 的 一 个 信息 窗口 ， 其 中 包含 了 与 单 击 位 置 相 
关 的 信息 。 除 此 之 外 , 加 载 所 选 位 置 名 称 和 地 址 的 模 态 框 容器 将 被 更 新 , 如 图 10.12 所 示 。 
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图 10.12 选取 评论 位 置 
在 用 户 选择 了 评论 位 置 后 ， 即 可 单 击 Done 按钮 关闭 模 态 框 ， 并 继续 填写 评论 的 标题 


和 内 容 ， 如 图 10.13 所 示 。 


Write your review 


Best restaurant ever!!! 


| lenjoyed eating here. The pizza was fantastic! 


£^ 


vc (EA 


Location selected 


图 10.13 


填写 评论 的 标题 和 内 容 


需要 注意 的 是 ， 评 论 表单 现在 表明 已 成 功 地 选择 了 评论 位 置 。 当 用 户 填写 所 有 的 评 
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论 信息 后 ， 即 可 单 击 Submit Review 按钮 提交 评论 内 容 ， 如 图 10.14 所 示 。 


king. kevin 


Best restaurant ever! 


enjoyed eating here. The pizza was 
fantastet 


图 10.14 提交 评论 内 容 

在 提交 了 评论 后 ， 用 户 将 被 重 定位 至 其 主页 ， 并 可 查看 所 提交 的 评论 。 单 击 主 页 中 评 
论 上 的 View location 按钮 将 显示 一 个 模 态 框 , 其 中 包含 了 评论 地 理 位 置 的 地 图 , 如 图 10.15 
所 示 。 


Reviewed location 


yy 
wlll ieee 


ae 


» Å kesa 


h cour Pose Colege 
9 pacer 


图 10.15 显示 评论 地 理 位 置 的 地 图 
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显示 于 用 户 的 地 图 包含 了 一 个 标记 ， 表 示 评 论 的 准确 地 理 位置 。 
至 此 ， 我 们 已 实现 Place Reviewer 应 用 程序 的 全 部 核心 功能 。 下 面 讨论 Spring 应 用 
程序 的 测试 行为 。 


10.2 Spring 应 用 程序 测试 


前 述 内 容 曾 简要 地 介绍 了 应 用 程序 的 测试 操作 ， 及 其 在 软件 设计 过 程 中 的 必要 性 。 
Spring 应 用 程序 可 通过 4 个 步骤 进行 测试 。 
(1) 向 项 目 中 添加 必要 的 测试 依赖 关系 。 
(2) 定义 配置 类 。 
(3) 配置 测试 类 并 使 用 自 定 义 配置 。 
(4) 编写 所 需 的 测试 程序 。 
下 面 将 对 上 述 步 又 逐一 加 以 讨论 。 


10.2.1 添加 测试 依赖 关系 


首先 需要 向 项 目 中 添加 测试 依赖 关系 。 打 开 Place Reviewer 项 目的 pom.xml 文件 , 并 
添加 下 列 依赖 关系 : 


<dependency> 
<groupId>junit</groupId> 
<artifactId>junit</artifactId> 
<version>4.12</version> 
<scope>test</scope> 
<exclusions> 
<exclusion> 
<groupId>org.hamcrest</groupId> 
<artifactId>hamcrest-core</artifactId> 
</exclusion> 
</exclusions> 
</dependency> 
<dependency> 
<groupId>org.hamcrest</groupId> 
<artifactId>hamcrest-library</artifactId> 


<version>1.3</version> 
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<scope>test</scope> 
</dependency> 


后 续 各 节 将 学 习 如 何 利用 jUnit 和 Hamcrest 编写 测试 程序 。JUnit 是 针对 Java 编程 语 
言 的 测试 框架 ， 而 Hamcrest 库 则 提供 了 匹配 器 ， 二 者 结合 使 用 后 可 创建 有 效 的 Intent 表 
达 式 。 


10.22 ”定义 配置 类 


定义 测试 配置 类 有 助 于 测试 的 正常 运行 。 在 Place Reviewer 项 目的 src/test/kotlin 目录 
H, 将 config 包 添 加 至 com.example.placereviewer 中 ， 并 向 该 包 中 加 入 TestConfig 类 ， 如 
下 所 示 : 


package com.example.placereviewer.config 


import org.springframework.context.annotation.ComponentScan 
import org.springframework.context.annotation.Configuration 


GConfiguration 
@ComponentScan (basePackages = ["com.example.placereviewer"]) 
class TestConfig 


10.23 ”利用 自 定 义 配 置 设置 配置 类 


对 此 ， 可 打开 Spring 应 用 程序 的 测试 类 ， 并 使 用 @ContextConfiguration 注解 指定 测 
试 类 所 用 的 配置 类 .相应 地 ,打开 PlaceReviewerApplicationTests.kt 文件 (位 于 src/test/kotlin 
目录 下 的 com.example.placereviewer 包 中 ) ， 并 按照 下 列 方式 设置 配置 类 : 


package com.example.placereviewer 


import com.example.placereviewer.config.TestConfig 

import org.junit.runner.RunWith 

import org.springframework.boot.test.context.SpringBootTest 
import org.springframework.test.context.ContextConfiguration 
import org.springframework.test.context.junit4.SpringRunner 


@RunWith (SpringRunner::class) 
GSpringBootTest 


第 103€ 实现 Place Reviewer 前 端 *397* 


GContextConfiguration(classes = [TestConfig::class]) 


class PlaceReviewerApplicationTests 


下 面 尝试 编写 应 用 程序 测试 内 容 。 
10.24 编写 第 一 个 测试 程序 


编写 应 用 程序 测试 与 编写 Spring 应 用 程序 其 他 部 分 的 代码 基本 类 似 ， 并 可 利用 应 用 
程序 其 他 部 分 中 的 组 件 和 服务 ， 下 面 将 对 此 了 予以 介绍 。 
向 com.example.placereviewer.service 中 添加 TestUserService 接口 ， 如 下 所 示 : 


package com.example.placereviewer.service 
import com.example.placereviewer.data.model.User 


interface TestUserService ( 
fun getUser(): User 


) 
随后 向 包 中 添加 TestUserServiceImpl 类 ， 如 下 所 示 : 


package com.example.placereviewer.service 


import com.example.placereviewer.data.model.User 
import org.springframework.stereotype.Service 


GService 
internal class TestUserServiceImpl : TestUserService ( 


//Test stub mimicking user retrieval 
override fun getUser(): User ( 
return User( 
"user(gmaiil.com", 
"test.user", 
"password" 


) 
返 
下 所 示 : 


HH 


至 PlaceReviewerApplicationTests.kt 文件 中 ， 对 其 进行 修改 以 反映 此 类 变化 ， 如 
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package com.example.placereviewer 


import com.example.placereviewer.config.TestConfig 

import com.example.placereviewer.data.model.User 

import com.example.placereviewer.service.TestUserService 
import org.hamcrest.Matchers.instanceOf 

import org.hamcrest.MatcherAssert.assertThat 

import org.junit.Test 

import org.junit.runner.RunWith 

import org.springframework.beans.factory.annotation.Autowired 
import org.springframework.boot.test.context.SpringBootTest 
import org.springframework.test.context.ContextConfiguration 
import org.springframework.test.context.junit4.SpringRunner 


GRunWith (SpringRunner::class) 

GSpringBootTest 

@ContextConfiguration(classes = [TestConfig::class]) 
class PlaceReviewerApplicationTests { 


@Autowired 
lateinit var userService: TestUserService 


@Test 
fun testUserRetrieval() { 


val user = userService.getUser() 


assertThat (user, instanceOf (User: :class.java) ) 
} 

} 

testUserRetrievalO 测 试 方法 在 执行 时 使 用 定义 于 TestUserServiceImpl 中 的 存根 (stub) 
方法 检索 用 户 ， 并 检测 该 方法 返回 的 对 象 是 否 为 User 类 实例 。 

当 运 行 测试 程序 时 ， 可 单 击 IDE 中 的 Run Test 按钮 ， 如 图 10.16 所 示 。 

此 时 ,testUserRetrieval 将 被 运行 ,运行 测试 结果 将 显示 于 IDE 窗口 的 下 方 ,如 图 10.17 
所 示 。 

运行 结果 表明 ， 当 前 程序 已 通过 测试 。 当 开发 更 大 、 更 复杂 的 应 用 程序 ， 并 为 应 用 
程序 模块 编写 测试 时 ， 读 者 将 会 发 现 ， 测 试 过 程 常常 会 失败 。 此 时 ， 读 者 应 保持 冷静 并 
对 程序 进行 调试 。 随 着 时 间 的 推移 ， 读 者 将 能 够 创建 更 加 可 靠 的 软件 。 
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PlaceReviewerApplicationTests.kt TestConfig.kt TestUserService.kt TestServicelmpl.kt 


图 10.16 运行 测试 程序 
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10.3 本 章 小 结 


章 完成 了 Place Reviewer 应 用 程序 ， 其 间 详 细 讨 论 了 Spring MVC 应 用 程序 视图 层 
的 构建 过 程 。 进 一 步 讲 ， 我 们 学 习 了 如 何 将 应 用 程序 与 Google Places API Web 服务 进行 
合 ， 进 而 实现 了 包含 定位 感知 特性 的 应 用 程序 。 
除 此 之 外 ， 本 章 还 借助 于 Validator 类 和 BindingResult， 介 绍 了 表单 输入 验证 方案 。 
最 后 ， 本 章 还 探讨 了 测试 的 配置 操作 ， 并 针对 Spring 应 用 程序 编写 相应 的 测试 方法 。 


后 idc 


如 果 读 者 正在 阅读 这 一 部 分 内 容 ， 相 信 您 已 经 完整 地 阅读 了 本 书 。 首 先 ， 请 允许 我 


向 读者 表示 更 心 的 祝贺 ! 您 对 Kotlin 这 门 语言 的 投入 和 执着 的 确 令 人 称赞 。 那 么 ， 接 下 


来 的 


问题 是 什么 ?这 一 问题 很 可 能 会 在 读者 的 脑海 中 闪 过 。 本 节 尝 试 对 此 予以 解答 。 
首先 ， 读 者 必须 努力 掌握 Kotlin 这 门 语言 ， 这 需要 大 量 的 实践 一 一 相信 我 ， 这 完全 


是 可 行 的 。 以 下 几 点 建议 仅 供 读者 参考 : 


O 每 天 使 用 Kotlin 语言 进行 程序 设计 ， 这 一 点 非常 重要 ， 并 可 确保 读者 不 断 巩 固 


所 学 到 的 知识 。 此 外 ， 这 将 有 助 于 读者 发 现 新 的 结构 、 模 式 、 数 据 结构 和 范例 ， 
从 而 提升 读者 的 编程 技能 。 

广泛 地 阅读 。 这 一 点 无 论 如 何 强调 都 不 过 分 。 为 了 掌握 相关 技能 ， 并 尽 可 能 
获取 更 多 的 知识 ， 读 者 必须 养 成 阅读 Kotlin 相关 话题 的 习惯 。 在 开始 阶段 ， 读 
者 可 尝试 阅读 Kotlin 参考 文档 ， 对 应 网 址 为 https://kotlinlang.org/docs/。 此 外 ， 
读者 还 可 阅读 其 他 与 Kotlin 相关 的 优秀 专著 。 

咨询 与 Kotlin 有 关 的 问题 。 在 学 习 Kotlin 这 门 语言 的 过 程 中 ， 很 多 时 候 都 会 经 
历 各 种 问题 。 这 里 的 建议 是 ， 不 要 对 这 些 问 题 置之不理 ， 否 则 读者 将 会 错过 一 
次 美好 的 学 习 经 历 。 针 对 于 此 ，Stack Overflow 和 Quora 等 平台 是 专门 为 知识 共 
享 而 打造 的 ， 读 者 应 确保 养 成 使 用 这 些 平 台 的 习惯 ， 并 及 时 寻求 问题 的 答案 。 
同样 ， 若 读者 具有 较 高 的 水 平 ， 也 可 以 自由 地 回答 问题 。 
尝试 使 用 工具 编写 程序 。 熟 练 地 掌握 一 种 工具 对 于 编写 Kotlin 应 用 程序 来 说 是 
不 可 或 缺 的 。 

如 果 读 者 保持 对 Kotlin 的 热情 并 遵循 这 些 建议 ， 那 么 ， 掌 握 这 门 语言 绝 非 难事 。 
这 里 ， 也 祝 您 一 路 顺风 ! 


